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SERIES 60 (LEVEL 6) 
GCOS 6 ASSEMBLY LANGUAGE 


REFERENCE 
SUBJECT 
Detailed description of Series 60 (Level 6) GCOS 6 Assembly Language 
including: 


e Central Processor Unit (CPU) Instructions 

e Scientific Instruction Processor (SIP) Instructions 
e Commercial Processor Instructions | 

e Assembler Control Statements 


e Macro Control Statements and Macro Calls 


SPECIAL INSTRUCTIONS 


This manual supersedes CBO7, Rev. 0 dated January 1978. Change bars 
indicate new and changed information; asterisks denote deletions. 


SOFTWARE SUPPORTED 


This publication supports Release 0110 of the Series 60 (Level 6) GCOS 6 MOD 
400 Operating Systems; see the Manual Directory of the latest GCOS 6 MOD 
400 System Concepts manual (Order No. CB20) AOE information as to later 
releases supported by this manual. 


ORDER NUMBER 
CBO7, Rev. 1 June 1978 


Honeywell 


Pretace 


This manual describes the GCOS 6 assembly language, a machine-oriented 
language for writing programs to execute on the Series 60 (Level 6) models. In 
this manual, unless stated otherwise, the term GCOS refers to the GCOS 6 
software; the term Level 6 refers to the Series 60 (Level 6) on which the 
described software is executed. 


Where appropriate, the actions performed by the GCOS Assembler as it 
processes elements of the assembly language are also discussed. In this manual, 
the term assembly language includes both Assembler control statements and 
assembly language instructions. | 


Section 1 describes the data prepresentation and the hardware registers. 
- Section 2 describes the basic elements of the GCOS assembly language, and 
Section 3 describes the considerations the programmer must make when 
writing a source program. Sections 4 and 5 describe, in detail, the Assembler 
control statements and assembly language instructions, respectively. Section 6 
and Section 7 consist of detailed descriptions of the commercial instructions and 
the scientific instructions. The macro facility is described in Section 8. Appendix 
A provides programmer reference information. Appendix B describes the 
hexadecimal numbering system. Appendix C contains a sample assembly 
language program. Appendix D describes how to debug an assembly language 
program. Appendix E lists the flags that may be issued by the Assembler. 
Appendix F lists the error flags that may be issued by the Macro Preprocessor. 
Appendix G contains a list of reserved symbolic names. Appendix H provides 
reference information for Commercial Processor operation. Appendix J and 
Appendix K provide reference information for queue instructions and stack 
instructions, respectively. 


_ Descriptions and examples within this manual use the following conventions: 


{} Indicates that one of the options enclosed in the braces must b 
selected. 


[] Indicates that one or none of the enclosed options need be selected; if one 
of the options is underlined, it is selected as the default if you do not 
select any of the options enclosed in the brackets. 


Indicates either a logical sequence (e.g., A,B...) or that the 
immediately preceding type of value can be repeated (e.g., a...). 


a Indicates that the character must be replaced by any valid ASCII 
character. 


n Indicates that the character must be replaced by any valid numeric 
(decimal) digit. 


d Indicates that the character must be replaced with a binary digit. 


h Indicates that the character must be replaced with a hexadecimal digit 
(0 through 9, A through F; the letters a through f are considered 
equivalent to the corresponding uppercase letters). 


c . Indicates that the character must be replaced with a, n, or h, above. 


A Indicates that one or more spaces or horizontal tab characters are 
required. 
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Uppercase letters, numbers, and any of the following special characters must 
be coded exactly as shown (lowercase letters that represent keywords, 
however, are considered equivalent to the corresponding uppercase letters): 


()  § 
/ 


* 


9 


[i tes I Ee 


Users of the Writable Control Store feature should refer to the Writable Control 
Store User’s Guide for information about the WCS instructions and the WCS 


Assembler, and to the GCOS 6 MOD 400 Operator’s Guide for command infor- 
mation to invoke the WCS Loader. 
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MANUAL DIRECTORY 


The following publications comprise the GCOS 6 manual set. The Manual 
Directory in the latest GCOS 6 MOD 400 Systems Concepts manual (Order No. 
CB20) lists the current revision number and addenda (if any) for each manual in 
the set. 


Order 
No. Manual Title 
--~ CBO1 GCOS 6 Program Preparation 
_— CB02 GCOS 6 Commands 
—~CBO03 GCOS 6 Communications Processing 
——~“CB04 GCOS 6 Sort/Merge | 
. CBO5 GCOS 6 Data File Organizations and Formats 
_. CB06 GCOS 6 System Messages 
B07 GCOS 6 Assembly Language Reference 
—CBO08 GCOS 6 System Service Macro Calls 
CBO09 GCOS 6 RPG Reference 
CB10 GCOS 6 Intermediate COBOL Reference 
—CB20 GCOS 6 MOD 400 System Concepts ~~ 
{CB21 } GCOS 6 MOD 400 Program Execution and Checkout 
—~CB22 GCOS 6 MOD 400 Programmer's Guide 
= CB23 GCOS 6 MOD 400 System Building 
/CB24 | GCOS 6 MOD 400 Operator’s Guide 
CB25 GCOS 6 MOD 400 FORTRAN Reference 
CB26 GCOS 6 MOD 400 Entry-Level COBOL Reference 
~-CB27 GCOS 6 MOD 400 Programmer’s Pocket Guide 
CB28 GCOS 6 MOD 400 Master Index 
CB30 Remote Batch Facility User’s Guide 
CB31 Data Entry Facility User’s Guide 
CB32 Data Entry Facility Operator’s Quick Reference Guide 
~~CB33 Level 6/Level 6 File Transmission Facility User’s Guide 
CB34 Level 6/Level 62 File Transmission Facility User’s Guide 
CB35 Level 6/Level 64 (Native) File Transmission Facility User’s Guide 
CB36 Level 6/Level 66 File Transmission Facility User’s Guide 
CB37 Level 6/Series 200/2000 File Transmission Facility User’s Guide 
CB38 Level 6/BSC 2780/3780 File Transmission Facility User’s Guide 
CB39 Level 6/Level 64 (Emulator) File Transmission Facility User’s Guide 
_CB40 IBM 2780/3780 Workstation Facility User’s Guide 
CB41 HASP Workstation Facility User's Guide ~ 
CB42 Level 66 Host Resident Facility User’s Guide 
CB43 Terminal Concentration Facility User's Guide 


In addition, the following documents provide general hardware information: 


Order | 

No. Manual Title 

AS22 Honeywell Level 6 Minicomputer Handbook 

AT04 Level 6 System and Peripherals Operation Manual 
AT97 MLCP Programmer’s Reference Manual 

FQ41 Writable Control Store User’s Guide 
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Section I 


Introduction 


Computer programs can be written in high-level languages or machine-oriented lower level 
languages. High-level languages are generally designed for specific environments (e.g., COBOL 
is a business-oriented language, and FORTRAN is a scientifically-oriented language). Low- 
level languages (i.e., assembly languages) support a wide range of application environments. 


ASSEMBLY LANGUAGES 


Computer logic interprets only machine (i.e., object) code. Since object code is composed of 
binary digits, it is difficult to understand unless the binary representation is translated into a 
more convenient, readable code. As a result, assembly languages have been developed to 
simplify the problem of writing programs in object code. These intermediate-level assembly 
languages consist of assembler-controlling statements and operational instructions. 


As illustrated in Figure 1-1, an Assembler interprets the assembly language (i.e., source code) 
program and translates it into object code, which the computer executes to produce the desired 
results. 
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Figure 1-1. Assembler Functions 


One of the primary differences between assembly languages and high-level languages is that 
each assembly language instruction is equivalent to a single machine-level instruction, 
whereas a single high-level language instruction can be translated into any number of 
machine-level instructions. The advantage, then, is that the assembly language gives you more 
control over the operations to be performed. 


LEVEL 6 DATA REPRESENTATION 


All data stored in main memory must be in predefined, system-recognizable formats. All data 
elements are based on 16-bit memory words. The format of each word is defined from left to 
right, with the first bit numbered 0 and the last 15. The leftmost bit (i.e., bit 0) is considered the 
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most significant and the rightmost (i.e., bit 15) is the least significant, with each intervening bit 
less significant than the one to its left. | 


Because of this predefined format, it is possible to access data at any of the following levels: 
e Bit — 1 bit | 

e 4— bit digit 

e Byte (half-word) — 8 bits 

e Word — 16 bits 

e Multiword — 32, 64 bits 


Regardless of the size of the data item being accessed, addresses generated by the operand(s) in 
an instruction point to the most significant bit of the item. For example, to access a multiword 
data item in main memory, the address generated by the Assembler (from the operand con- 
tained in the instruction) points to the first bit (.e., bit 0) in the first word of the item. 


Each four bits of data are represented by a single hexadecimal value in a listing or printout, 
although the bits are stored in memory in binary form. The hexadecimal equivalent of a binary 
value is derived by converting each successive four bits to the hexadecimal value as follows: 


0000 = 0 1000 = 8 
0001 = 1 1001 = 9 
0010 = 2 1010= A 
0011= 3 1011= B 
0100 = 4 1100 = C 
0101 = 5 1101 = D 
0110= 6 1110= E 
0111= 7 1111= F 


Thus, ifa listing shows that a word at a given address contains the hexadecimal value 8FD3, it 
means that the system contains the stored binary vaiue 1000111111010011. | 

Data stored in memory can be in any of the following forms: 

e Signed integer 

e Unsigned integer 

e Floating-point 

A signed or unsigned integer byte can also be stored in a hardware general register. A 


floating-point constant occupies two (short-precision) or four (long-precision) memory words 
and may also be stored in the scientific registers. 


SIGNED INTEGER DATA 


Signed integers stored in memory contain a sign (0 = +; 1 = —) in bit 0 and the data in the 
remaining bits. Negative numbers appear in twos-complement form. Byte, word, and double- 
word formats are permitted, as follows: , 
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Bit: 0 |] 15 16 31 
{i DATA Double-word 


If the first digit in the hexadecimal representation of a signed integer is 0 through 7, the value 
is positive and is stored in memory exactly as it was coded; if the first digit is 8 through F, the 
value is negative and is stored in memory as the twus complement of the coded integer. For 
example, if the contents of a signed integer word appearing in memory are BDAO, the decimal 
equivalent is -16992. 


When a signed integer byte is loaded from memory into a hardware general register, the seven 
data bits are placed into bits 9 through 15 of the register and the sign into bit 8. The sign is then 
extended through bit 0 of the register, as follows: 


Bit: 


© 


78 9 15 
Cherere 
o00000g of, PATA 


o— 
~=—ee 


The sign of the integer byte (i.e., the first bit of the 8-bit byte), which is contained in bit 8 of the 
register, is extended through the first byte of the register. 


If the first byte of the register contains the hexadecimal value FF, the integer in the second 
byte is a negative value; if the first byte contains the hexadecimal value 00, the value of the 
second byte is positive. 


UNSIGNED DATA 


Unsigned data appears in memory in three possible formats: 


Bit: 0 7 
DATA Byte 
Bit: 0 | 15 
| DATA Word 
Bit: 0 | | 31 


DATA Double-word 


When an unsigned data byte is loaded from memory into a hardware general register, the byte 
is placed into register bits 8 through 15, and register bits 0 through 7 are set to 0, as follows: 


Bit: 0 7 8 15 


00000000 DATA 
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FLOATING-POINT DATA 


Floating-point data appears in memory either as a short-precision (32-bit) or long-precision 
(64-bit) constant, as follows: 


Bit: 0 67 8 1 ee ; 
Bit: 0 678 — 63 


Represents the characteristic (excess 64 power-of-16 exponent) of the number. The 
characteristic represents exponents with a range from —64 to +63. Since the charac- 
teristic has no sign bit, the number 64 (decimal) is effectively added to each exponent, 
thus allowing a characteristic range of 0 to 127 to represent exponents with a range of 
—64 to +63. 


S 

Sign bit (0 = +; 1 = —) of the mantissa. 
M : : 
Mantissa — a normalized hexadecimal fraction. | 


A floating-point constant in memory may be loaded into a scientific register or a software- 
simulated scientific register, described later in this section. 


HARDWARE REGISTERS 


Level 6 hardware registers (Figure 1-2) consist of word operand registers, address registers, 
control registers, and mode registers. 


ADDRESS REGISTERS 


The length of the address registers is 16 bits for 6/30 models and 20 bits for 6/40 and 6/50 
models. (The 12 leftmost bits of the 32-bit LAF address in memory must be zero.) 


BASE (Bn) REGISTERS 


The seven base registers are used in the formulation of addresses by pointing to any proce- 
dure, data, or location in main memory. Typically, the base registers contain addresses, poin- 
ters, or base references for use in generating effective addresses and referring to data through 
relative addresses (see “Addressing Techniques” in Section 5). 


PROGRAM COUNTER (P-REGISTER) 


The program counter (P-register) is used by the central processor to generate the effective 
address of data based on various operands in the assembly language instruction set. (See 
“Addressing Techniques” in Section 5.) The P-register contains the address of the next 
instruction only during execution of the current instruction. The address of the next instruction 
is the address of the current instruction plus the length of the current instruction. However, 
JMP, ENT, LNJ, and branch instructions modify the contents of the P-register to a jump or 
branch address. 


REMOTE DESCRIPTOR BASE REGISTER (RDBR) 
This register is used with Commercial Processor instructions and is available only on 6/40 and 


6/50 models. See Appendix H “Programmer’s Reference Information for Commercial Processor 
Operation.” 
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STACK REGISTER (T) 


This register is used with stack instructions and is available only on 6/40 and 6/50 models. See 
Appendix K “Programmer’s Reference Information for Stack Instructions.” 


( GENERAL (Rn) REGISTERS 


The seven general registers can be used as accumulators, and the first three (R1, R2, R3) can 
be used as index registers (see “Addressing Techniques” in Section 5). 


MODE (M) REGISTERS 


Register M1 contains the trap enable control bits. Its contents can be altered by the MTM 
assembly language instruction, and used by other instructions in the assembly language 
instruction set. The bits in the M1 register have the following meanings when set to binary 1: 


Bit: 012345 6/7 


Overflow trap enabled for R7 
Overflow trap enabled for R6 
Overflow trap enabled for R5 
Overflow trap enabled for R4 
Overflow trap enabled for R3 
Overflow trap enabled for R2 
Overflow trap enabled for RI] 
Trace trap enabled for JMP and branch instructions 


eae, Setting one or more overflow trap bits makes it possible to enter the Trace Trap Handler by a 
( trap to Trap Vector 6. See the System Services Macro Calls manual for a detailed description of 
trap handlers. 
Registers M2, M6, and M7 are reserved for future use. 


The format of the Commercial Processor control register M3 is the same as that of the 
Commercial Processor mode register which is described later in this section. 


The formats of registers M4 and M5 are the same as those of the SIP mode register and the SIP 
trap mask register respectively. These registers are described later in this section. 


SYSTEM STATUS (S) REGISTER 


The S-register contiiins the status and security bits for the system. The contents, which can be 
read by an executing program, have the following meaning, depending on which bits are set to 
binary 1: 


Bit: O12 56 9 10 15 


ID 
1 & Level Number 


Interrupt priority level of the 
executing program; 63 (all bits 
set to 1) is the lowest level; 
0 (all bits set to 0) is the 
highest 


Processor identifier; set automatically 
during system configuration. 


Indicates that the system is running in 
privileged state. 
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WORD OPERAND REGISTERS 


GENERAL REGISTERS INDEX 
0 | 15 AND ACCUMULATORS REGISTERS 
<——_—_—__—_—————- _—_———— 
ee eee ae eee ee 
——_______ 
xt 
—————--—_— 
PROGRAM ADDRESS BASE, 
COUNTER POINTER, STACK 
ee ————— 
———————— 
Sa SERRE 
rs 
———_________ 
a 
—————___-_-_—. 
—— 
————__—— 
<——_____ 
CONTROL REGISTERS 
0 : 15 
S ~<——SYSTEM AND SECURITY KEYS 
~<—|NDICATORS 
0 | 7 
M1 ~4— TRAP ENABLE/MODE CONTROL 
M2 RESERVED 
M3 CIP CONTROL 
M4 SIP MODE 
M5 <— SIP TRAP MASK 
M6 RESERVED 
M7 RESERVED 


*15 FOR 6/30 MODELS, 19 FOR 6/40 AND 6/50 MODELS 


Figure 1-2. Level 6 Registers 


If the hardware configuration includes a Memory Management Unit, the contents of the 


S-register have the following meaning: 


56 9 10 15 


11D] LEVEL 
4 NO.| NUMBER 


Bity 0123: 
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Interrupt priority level of the 
executing program; 63 (all bits 
set to 1) is the lowest level; 
0 (all bits set to 0) is the 
highest 


Processor identifier; set auto- 
matically during system con- 
figuration. 


Indicates the ring number the 
system iS running in. 
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INDICATOR (I) REGISTER 


The I-register contains overflow and program status indicators. When set to binary 1, the bits 
have the following meaning: 


Bit: 0 78 9 10 11 12 13 14 #15 


jcfs}sfe fe fu 


Result of last 
compare iS: 
Unequal signs 
Less than 
Greater than 


Indicates that device 
accepted I/0 command. 


Bit-test indicator (see the 
descriptions of the follow- 
ing instructions in Section 
5 for the setting: LB, LBC, 
LBF, LBS, LBT). 


Carry occurred during 
arithmetic operation. 


Overflow occurred during 
arithmetic instruction. 


SCIENTIFIC INSTRUCTION PROCESSOR (SIP) REGISTERS 


The Level 6 Scientific Instruction Processor (SIP) is an optional hardware unit containing 
three identical scientific accumulator registers, one scientific indicator register, one SIP mode 
register, and one SIP trap mask register. The SIP performs arithmetic operations on single- and 
double-precision floating-point data and also provides a set of scientific branch instructions. 


SCIENTIFIC ACCUMULATOR (Sn) REGISTERS 


The SIP provides three 64-bit scientific accumulator registers for use in either short- or 
long-precision floating-point operations. When these registers are used in short-precision 
operations, only the high-order (leftmost) 32 bits participate. 


The format of the scientific accumulator registers is shown below. 


Bit: 0 678 | 63 


Magnitude of the mantissa. 


Sign (0 = positive; 1 = negative) of 
the mantissa. 


Characteristic (excess 64 power-of-sixteen 
exponent) of the number. 
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SCIENTIFIC INDICATOR (SI) REGISTER 


The 8-bit SlI-register contains error and status indicators that can be tested with the scientific 
branch instructions. When set to binary 1, the bits have the following meanings: 


5 6 


4 


0 1 2 3 
a 


7 


Result of last 
scientific compare: 


Less than 
Greater than 


Precision error (trap 22) 


Significance error (trap 21) 
QLT error (trap 31) 
Exponent underflow (trap 19) 


Traps and trap handlers are discussed in the System Services Macro Calls manual. 


SIP MODE (M4) REGISTER 


The SIP mode, or M4, register is an 8-bit control register residing in the SIP but with a copy in 
the CP. Both versions are set to 0 upon CP initialization and both may be modified with an MT™M 
instruction (see Section 5). If only the SIP is initialized, the CP copy of the register is not cleared, 
and the contents of both versions must be reestablished with an MTM. 


The format of the M4-register is as follows: 


0 1 2 3 4 =) 6 7 


R/T: Round/Truncate Mode 
0— Truncate 
1— Round 
ML: Memory length (Length of main memory data field to or from which data is 
transferred via a scientific accumulator (SA)) 
0— Two words 


1— Four words 
AL: Accumulator Length (Length of scientific accumulator data field to or from which 
data is transferred to/from main memory, a hardware register, or another SIP 
register) 
Q— Two words 
1— Four words 
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SIP TRAP MASK (M5) REGISTER 


The SIP Trap Mask, or M5, register is an 8-bit control register residing in the SIP but with a 
copy in the CP. Both versions are set to 0 upon CP initialization and both may be modified with 
an MTM instruction (see Section 5). If only the SIP is initialized, the CP copy of the register is not 
cleared, and the contents of both versions must be reestablished with an MTM. 


The format of the M5-register is as follows: 


Precision error trap mask 


Significance error trap mask 


Exponent underflow trap mask 


SOFTWARE SIMULATION OF THE SCIENTIFIC INSTRUCTION PROCESSOR 


For systems on which a Scientific Instruction Processor (SIP) is not available, GCOS provides 
the equivalent SIP functions through software simulation. Two simulators are available: the 
Single-Precision SIP Simulator (SSIP) and the Double-Precision SIP Simulator (DSIP). If a 
configuration is to support scientific instructions when a SIP is not present, SSIP or DSIP must 
be specified in the CLM directive SYS. (See System Building manual.) 


The DSIP simulates all functions of the SIP. The SSIP is a partial simulator. The simulators 
are entered via trap vector 3 (for scientific floating-point instructions) or trap vector 5 (for 
scientific branch instructions). 


Note the following considerations with respect to the use of the SSIP. 


e SSIP uses registers R4, R5, and R7 to simulate a scientific register (assumed to be SA1). A 
task that executes scientific instructions that might be simulated by SSIP should dedicate 
these three registers to the use of the simulator. 


e SSIP uses the CPU I-register to store the results of a scientific compare instead of 
simulating the scientific indicator register. Thus, if scientific compare instructions are to 
be simulated by SSIP (as opposed to being simulated by DSIP or executed by the SIP), then: 
— CPU branch instructions must be used to test the result of a scientific compare instead 

of the normal scientific branch instructions. 
— Execution of scientific instructions alter the CPU I-register instead of the SIP’s SI 
register. 


e On 6/30 systems, the SSIP does not support the MTM or STM instruction. 


e SSIP rounds results when appropriate; DSIP truncates results unless otherwise in- 
structed. Thus, results produced by the SSIP may not agree exactly with those produced by 
the DSIP. | 


COMMERCIAL PROCESSOR REGISTERS 


The Commercial Processor, an optional hardware unit, contains two registers: the Commer- 
cial Processor mode register, and the Commercial Processor indicator register. 


COMMERCIAL PROCESSOR MODE REGISTER 


The 8-bit Commercial Processor mode register is a copy of the M3 register (in the CPU) which 
is provided for use with the Commercial Processor. Both are set to zero at initialization of the 
CPU. Both registers may be modified with an MTM instruction. If only the Commercial 
Processor is initialized, the M3 register is not cleared, and the contents of both registers must be 
established with an MTM instruction. The format of the Commercial Processor mode register 
and the M83 register is shown below. When set to binary 1, the bits have the following meanings: 
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Trap on truncation 
Trap on overflow 


Note that, although the contents of the Commercial Processor mode register is not saved, the 
equivalent information in the M3 register is saved or restored as a function of the mask bits in 
the interrupt save area. When a restore is done, the restored value is sent to the Commercial 
Processor by the CPU. 


COMMERCIAL PROCESSOR INDICATOR REGISTER © 


The 8-bit Commercial Processor indicator register is cleared at initialization. During the 
execution of an instruction that affects the register, only the bits pertinent to the instruction are 
preset (set or reset). All other bits remain unchanged. During the execution of a branch 
instruction, all bits including the one being tested are left unchanged. When set to binary 1, the 


bits have the following meaning: 
0 1 2 S) 6 / 
—-—E: ss : QLT error 
Result of 


last compare is: 


Less than 
Greater than 
Sign fault 
(negative operand is stored 
in unsigned field) 
Alphanumeric result is truncated 


Overflow occurred during 
decimal instruction 


The contents of the Commercial Processor indicator register will be saved or restored as a 
function of the mask bits in the interrupt save area. 


SOFTWARE SIMULATION OF THE COMMERCIAL PROCESSOR 


For systems on which a Scientific Instruction Processor (SIP) is not available, GCOS provides 
the equivalent SIP functions through software simulation. Two simulators are available; the 
Single-Precision SIP Simulator (SSIP) and the Double-Precision SIP Simulator. If a configura- 
tion is to support scientific instructions when a SIP is not present, SSIP or DSIP must be 
specified in the CLM directive SYS. (See System Building manual.) . 
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INITIALIZATION AND MODIFICATION OF M-REGISTERS 


When each task starts, the operating system establishes the following default values for 
registers M1, M3, M4, and M5. | 

M1 00 ‘Trace trap and all R-register overflow traps disabled. 

M3 00 Commercial Processor overflow trap and truncation trap disabled; Commer- 
cial Processor is under direct CPU firmware control (i.e., not in software test 
mode). 

M4 = 03 Truncation mode is in effect, Scientific accumulators $S1 and $S2 and 
associated memory operands are two words long; $S3 and associated memory 
operands are four words long. 

M5 = 20 Significance error trap enabled; exponent underflow and precision error traps 
disabled. 


The contents of these registers can be modified by the assembly language instruction MTM. 
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Section 2 
Elements of 


Assembly Language 


The principal elements of Level 6 assembly language are: 

e Mnemonic codes 

e Symbolic names 

e Constants 

e Expressions 

These elements are combined to form a source program that consists of: 

1. Machine instructions to be assembled, on a one-to-one basis, into their corresponding 
object code representations. 


2. Assembler control statements, which are interpreted by the Assembler to control the 
assembly process, allocate work and storage areas in memory, and define constant data 
used by the program. 


3. Macro call statements, which are interpreted by the Macro Processor to further define the 
source program. 


MNEMONIC CODES 


Assembler control statements, which direct the Assembler in the preparation of object code, 
and assembly language instructions are specified by predefined mnemonic names of one to six 
characters in length. These mnemonic (operation) codes are described, in detail, in Sections 4 
and 5. 


SYMBOLIC NAMES 


Locations, values, and other data pertinent to the determination of assembly language 
instruction or Assembler control statement operand values can be referred to by the use of 
reserved (predefined) and user-defined names. | 


Character strings can be assigned as names of memory locations, registers, values, or other 
objects to be referred to in the development of object code. The manner in which a symbolic name 
is defined depends on the attributes of the object referred to by that name. 


Regardless of the manner of definition and the type of object being referred to, the symbolic 
name must conform to the following rules: 
It must be from one to six characters long. 
It must be composed of alphabetic characters (A,B,...Z), digits (0,1,...9), and/or the special 
characters $ and (underscore). 
3. The first character must be a $ or alphabetic character. 
4. The lowercase alphabetic characters are considered equivalent to the corresponding 
uppercase characters. 
The following types of symbolic names can be used in Assembler control statements and 
assembly language instructions: | 


e Identifiers — Reserved symbols designating the hardware registers, the scientific 
accumulators, and certain address syllables. 


e Labels— User-defined and reserved symbols designating locationsin memory and values. 
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IDENTIFIERS — 


Identifiers are reserved symbolic names that refer to hardware registers or to the software- 
simulated registers. In addition, names that are defined to be equivalent to identifiers (through 
the EQU Assembler control statement) are treated as identifiers. 


The following identifiers refer to hardware registers: 

e $Bl1 through $B7 — Base registers 

e $R1 through $R7 — General registers 

e $R1 through $R3 — Index registers 

e $M1 through $M7 — Mode control registers 

e $81 through $83 — Scientific accumulator registers 


LABELS 


Labels are symbolic names that can be used to refer to locations and values. They must be 
defined in a manner specific to the attributes of the location or value to which they refer (i.e., 
each label is typed according to the location or value attributes, which also establish the context 
in which they can be used). The types of labels and their methods of definition are as follows: 


e Internal location label — Refers to a location allocated within the assembled program. It is 
defined by its occurrence in the label field of an instruction (resulting in the allocation of 
memory to the program). The definition of labels appearing in certain Assembler control 
statements that do not cause memory to be allocated (e.g., EQU statement) depend on the 
statement and its operands. 


e External location label — Refers to a location in another independently assembled or 
compiled program. It is defined by appearing in the operand list of an XLOC statement. 


e Common location label — Refers to a location allocated to FORTRAN-compatible common 
blocks. It is possible to specify that the object code resulting from assembly language — 
instructions is to be allocated to a common block area rather than to the internal area 
normally allocated to the program. All labels that appear in instructions that result in the 
allocation of common block locations are defined as common location labels. In addition, 
labels specified in the COMM and LCOMM statements are defined as common location 
labels; these labels can be used to refer to locations in the common block by indicating their 
offset from the first word. , 3 

e Internal value label — Refers to a value defined within the program. It is assigned by its 
occurrence in the label field of an EQU statement with an operand expression (see 
“Expressions” later in this section) that yields a dimensionless value. 


e External value label — Refers to a value defined in another, independently assembled 
program. It is defined by appearing in the operand list of an XVAL statement. 


e Complex label — Refers to the label of an EQU statement that has an address expression 
(see “Expressions” in this section), or the label of another EQU statement that has an 
address expression, in the operand field. 


Table 2-1 summarizes the types of labels and how they are defined. 


USER-DEFINED LABELS 


User-defined labels can be either permanent or temporary. Permanent labels can be defined 
only once in a program; they must conform to the rules listed under “Symbolic Names” in this 
section. | 


The 26 temporary labels ($A, $B, ... $Z) may be defined as often as necessary within a single 
program. They may be referred to only in the operand of a hardware instruction or of a define 
constant (DC) assembly control statement. You must be careful, during programming, that you 
are referring to the desired definition of a temporary label when the label has multiple defini- 
tions within a single program. 


Temporary labels must be defined as internal location labels. 
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Type 


TABLE 2-1. DEFINING SYMBOLIC NAMES 


How Defined 


Internal location label Appears in label field of an assembly language instruction or 


Assembler control statement (except EQU, COMM, or LCOMM 
statements) when the location counter type attribute (set by the ORG 
statement) is internal. : 


External location label Appears in the operand field of an XLOC statement. 
Common location label Appears in the label field of aCOMM or LCOMM statement; or appears 


in label field of an assembly language instruction or Assembler control 
statement (except EQU, COMM, or LCOMM statements) when the 
location counter type attribute (set by the ORG statement) is common. 


Internal value label Appears in label field of an EQU statement that has an expression that _ 


yields a dimensionless arithmetic value in the operand field. 


External value label Appears in the operand field of an XVAL statement. 
Complex label Appears in the label field of an EQU statement that contains an 


address expression in the operand field; or appears in the label field of 
an EQU statement that contains a label identifying another EQU 
statement that contains an address expression in the operand field. 


Same as operand Appears in the label field of an EQU statement that contains an 


operand other than one of those listed above; e.g., an identifier. 


RESERVED LABELS 


Reserved labels are predefined and cannot be redefined. The following reserved labels are 
available: 


$ — The Assembler maintains a location counter which contains the address of the next 
available object memory location. The symbol $ represents this address and has the 
attribute of internal location or common location, depending on whether the program is 
currently “origined” in a non-common area or in acommon block, respectively. The initial 
value of the location counter is location zero. 


The Assembler also maintains a byte indicator which indicates whether the next available 
byte of object memory is the even (i.e., high order or left) or odd (i.e., low order or right) byte 
of the word whose address is contained in the location counter. The only statement that 
causes memory to be allocated that is permitted when the byte indicator is set to indicate 
the odd byte is the Byte Text (BTEXT) Assembler control statement. The byte indicator is 
initially set to indicate the even byte. 


Normally, the location counter is incremented by the number of words required to store the 
object code resulting from a given statement after the statement has been processed. 
Normally, the byte indicator is not altered. Exceptions to this general rule are as follows: 


—Assembler control statements, such as Equate and Common, that do not cause any 
memory to be allocated have no affect on either the location counter or the byte indicator. 


—The Origin Assembler control statement which sets the location counter to a specified 
value and sets the byte indicator to indicate the even byte. 


—The Byte Origin Assembler control statement which sets the location counter to a 
specified value and sets the byte indicator to indicate the odd byte. 


—The Define Constants (DC) Assembler control statement which does not affect the byte 
indicator, but increments the location counter after each operand is processed. Thus, a $ 
appearing as a label in an operand of a DC statement will always refer to the first, or 
only, word of memory allocated for that operand. Because of this, the DC statement: 


DC 1,2,<$-2 
will produce the same object code as the following DC statements: 
DC 1 
DC 2 
DC <$-2 


—The Byte Text Assembler control statement which increments the location counter and 
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byte indicator, concatenated to form a byte address, by the number of bytes allocated. 
Either, or both, the location counter and byte indicator may be altered. 


—The Pointer Array (PTRAY) Assembler control statement which does not affect the byte 

- indicator and increments the location counter after each operand is processed. Thus, a $ 

appearing as a label in an operand ofa PTRAY statement will always refer to the first, or 
only, word of memory allocated for that operand. 


—The Argument List (ARGLST) Assembler control statement which does not affect the 
byte indicator and increments the location counter as follows: 


—First the location counter is incremented by 1 after the control word is allocated, but 
before the first operand is processed. | 


—Then the location counter is incremented after each operand is processed. 


Thus a § appearing as a label in an operand of an ARGLST statement will always refer to 
the first, or only, word of memory allocated for that operand. 


—The Call (CALL and CALL2) Assembler control statements, which do not affect the byte 
indicator, but increment the location counter at various times, as appropriate for the 
breakdowns shown for these statements in Section 4. 


—The Input/Output statements, which do not affect the byte indicator, but increment the 
location counter after each operand is processed. Thus a $ appearing as a label in an 
operand of an Input/Output statement will always refer to the word of memory contain- 
ing that operand’s address syllable. 


—The Commercial Processor nonbranch statements, which do not affect the byte indicator, 
but increment the location counter as follows: 


—F irst the location counter is incremented by 1 after the op code word is allocated, but 
before the first operand is processed. 


—Then the location counter is incremented after each operand is processed. 


Thus a $ appearing as a label in an operand of a nonbranch Commercial Processor 
instruction will always refer to the first, or only, word of memory allocated for that 
operand. 


e $AF— This label refers to the address mode requested by the user. $AF is 1 for SAF, and 2 


for LAF or SLIC. 
e $IV — Refers to the content of the interrupt vector for the priority level at which the 


application is currently executing. A description of interrupt vectors and priority levels 
can be found in the System Services Macro Calls manual. 

e $RZERO — Refers to relocatable location zero of the program. $RZERO is an internal 
location label. 

e $SW — Refers to the current status of the external switches. The Assembler requests the 
value of the external switches from the operating system; $SW is then defined to be this 
16-bit value which corresponds to External Switch 0 through External Switch 15. The high 
order bit is switch 0. $SW is an internal value label. Use of $SW with conditional 
Assembler control statements provides a method of varying the assembly procedure 
without altering the assembly language source program. (See the Commands manual fora 
discussion of the Modify External Switches Command.) 


CONSTANTS 


Arithmetic and nonarithmetic values can be expressed in decimal, hexadecimal, character, or 
binary form, all of which are converted by the Assembler to the appropriate machine code 
format. Depending on the context, such values may be assigned as object code or be used by the 
Assembler in the computation of operand locations or values. 


The following types of constants are supported: 
e String constants | 


e Arithmetic constants 
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STRING CONSTANTS 


: String constants can be expressed as ASCII, hexadecimal, or bit strings. Regardless of how 
they are expressed, string constants have the following format: 


A 
[(n)]]4Z ¢] Te...F 
B 


[(n)] 
Specifies an optional decimal integer in the range from 1 to 255, which represents the 
replication factor (the string is concatenated to itself n-1 times). 


Specifies whether the string is expressed in ASCII (A, default if none of these values is 
specified) hexadecimal (Z), or bit (B). 
Te...) 


Identifies the character(s) in the string. 


ASCII STRING CONSTANTS 


An ASCII string constant is written as the letter A (optionally) followed by a string of any of 
the valid ASCII characters enclosed within apostrophes; to include an apostrophe, a double 
apostrophe must be specified (i.e., ”is interpreted as’). 


An ASCII string constant denotes the value formed by replacing all double apostrophes by a 
single apostrophe and removing the delimiting apostrophes. 

The value of an ASCII string constant cannot be more than 255 ASCII characters (each of 
which is eight bits long). 
oa The format of an ASCII string constant is as follows: 
( [(n)] [A] ‘a...7 

The following examples illustrate how to specify ASCII string constants: 

1. ‘ASCIT SAMPLED’ 

2. A ‘ASCIT SAMPLE2’ 

3. (4)A ‘(DATAA’ 

The characters enclosed within the apostrophes can be any character shown in Table B-4. The 
examples shown above result in the following values being stored in memory, respectively: 

1. ASCII SAMPLE1 

2. ASCIT SAMPLE2 

3. DATAA DATAA DATAA DATAA 


HEXADECIMAL STRING CONSTANTS 

A hexadecimal string constant is written as the letter Z followed by a string of characters 
representing any of the valid hexadecimal digits (i.e., 0 through 9 and A through F) enclosed 
within apostrophes. ' | 

A hexadecimal string constant denotes the value formed by replacing the characters 
contained within the delimiting apostrophes with their binary values and removing the 
delimiting apostrophes. | 

The value of a hexadecimal string constant cannot be more than 510 hexadecimal digits (each 
of which is four bits long). 


'The lowercase letters a through f are considered equivalent to the corresponding uppercase letters. 
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The format of a hexadecimal string constant is as follows: 
[(n)] Zh...) 
The following example illustrates how to specify a hexadecimal string constant: 
Z'5449544C452053414D504C4531’ 
This example translates into TITLEA SAMPLE1 (see Appendix B). 


BIT STRING CONSTANTS 


A bit string constant is written as the letter B followed by a string of characters representing 
the binary digits (i.e., 0 and 1) enclosed within apostrophes. A bit string constant denotes the 
value formed by converting the 0 and 1 characters contained within the delimiting apostrophes 
to 0 and 1 bits. The value of a bit string constant cannot be more than 2040 binary digits (each of 
which is one bit long). 


The format of a bit string constant is as ae 
[(n)] B‘[b... 

The following example illustrates how bit string constants are expressed: 
B‘00011010’ 


This bit string provides an 8-bit mask that can be used by an assembly language instruction. 


TRUNCATION/PADDING OF STRING CONSTANTS 


Various statements require a half-word (8-bit) value, whole-word (16-bit) value, or a value 
that is an integral number of words in length. In order to satisfy these requirements, string 
constants are automatically truncated or padded. | 


If truncation is required, low-order (i.e., the rightmost) bits are discarded, and the Assembler 
issues a diagnostic message. 


If padding is required, low-order bits are appended to the value (i.e., string constants are 
left-justified). ASCII string constants are padded with spaces; hexadecimal and bit strings are 
padded with 0’s. 


Table 2-2 describes how the Assembler handles the various situations that require truncation 
or padding. 


TABLE 2-2. RULES OF TRUNCATION/PADDING STRING CONSTANTS 
If a string constant appears: It is converted to: 


In a nontrivial arithmetic expression A whole-word value. 
As the only term of the operand ofa __ A _half-word value. 


short value immediate (SI) instruction 
As the only term of an operand of a A value having a length that is an integral number of 
___ DC Assembler control statement _ words; such string constants are never truncated. ____ 
As the operand of a TEXT Assembler A string having an initial bit offset which is a 
control statement multiple of 4 (for hexadecimal string constants) 
or a multiple of 8 (for ASCII string constants) 
with slack bits inserted between successive 
operands. A bit string constant can begin at any 
bit position; slack bits never precede a bit string 
operand. 
In any context not listed above A..whole-word value. 


Notes: 
1. Iftwoor more rules apply to the same string constant, the first takes precedence. 
2. Refer to specific statements identified in this table for additional information. 
3. Double integer instructions (AID, LDI, SDI, and SID) require string constants or 
double precision fixed-point constants to fully define 32 bits (.e., 2 words). 
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ARITHMETIC CONSTANTS 


An arithmetic constant specifies the value of a real number. An arithmetic constant is either -. 
binary integer constant, a decimal integer constant, a fixed-point constant, or a floating-point 
constant. 


BINARY INTEGER CONSTANTS 


Binary integer constants can be represented in decimal or hexadecimal notation. They may be 
preceded by a plus(+) or minus(—) sign, indicating a positive or negative value respectively, and 
must be within the range — 32768 to + 32767; if unsigned, a binary integer constant is assumed 
to be positive. 


i | n[n...] 
- X‘hfh...] 


4 

Specifies whether the value is positive (+, the default value) or negative (—). 
n{n...] 

Specify decimal digits. 
h{h...] 

Specify hexadecimal digits 


Binary Integer Constants in Decimal Notation 


A binary integer constant expressed in decimal notation is written as a character string 
composed of the decimal digits 0 through 9. The following examples illustrate valid binary 
integer constants in decimal notation. 


1. 31764 
2. +4652 
3. —6781 


Binary Integer Constants in Hexadecimal Notation 


A’binary integer constant expressed in hexadecimal notation is written as the letter X 
followed by a character string composed of the hexadecimal digits 0 through 9 and A through F 
(the lowercase letters a through f are considered equivalent to the corresponding uppercase 
letters) within apostrophes. The following examples illustrate binary integer constants in 
hexadecimal notation. 


1. +X°2F 
2. X°7FFF 
3. —X*8000’ 


The decimal equivalent of these examples is + 47, +32767 and — 32768 respectively as can be 
determined by reference to Table B-3. 


Decimal Integer Constants 


Decimal integer constants are represented by a letter from the set L,T,O,N,P,U followed by a 
character string enclosed in apostrophes. In general, they may be preceded by a plus (+) or 
minus (—) sign indicating a positive or negative value. The letter indicates whether the value is 
internally represented as a packed or unpacked number and designates the internal sign 
convention. The character string is composed of the digits 0 through 9. Decimal integer 
constants begin at a word boundary and occupy an integral number of words, peeeIny including 
trailing digits which may be unused. 
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Unpacked Decimal Integers 


The prefix letter designating the internal sign convention and the range of values allowed for 
each convention of unpacked decimal integers are as follows: 


Sign Convention Letter Range of Values 
Leading separate L —10”<n<+10*” 
Trailing separate T —10”<n<+10” | 
Trailing overpunch O —107<n<+10*? 
Unsigned N 0<n<10* 


The storage formats for separate signed unpacked decimal integers are as follows: 


Leading sign 


K-—8(p+1) bits —>| 


Trailing sign Lael § | 
K—8 (ptl) bits ——>| 


_In these formats, dn is the ASCII representation of a decimal digit, S indicates the sign, and p 
indicates the precision, which must be greater than zero and less than 32. The plus sign is 
represented by the ASCII character + (hexadecimal 2B) the minus sign by the ASCII character 
— (hexadecimal 2D). 


The format of an unpacked decimal integer with the sign indicated by a trailing overpunch is 
as follows: 


el, jlo 


The rightmost character in storage depends on the least significant digit of the integer and on 
whether the integer is positive or negative as shown below. 


Least eee eee ee = 


Positive| ASCII graphic 
Hexadecimal code | ‘ 


Negative] ASCII graphic 
Hexadecimal code I, 


The format of an unsigned unpacked decimal integer is as follows: 


alal Te 


|<——8p bits-——>| 


Packed Decimal agen 


42 43 a4 re a6 4 48 49 


i 
4A 


1B 4c 4D aE AF 50 31 52 


The prefix letter and the range of values for signed and unsigned packed decimal integers are 
as follows: 


Prefix Letter Type Range 
P Signed —10*%<n<+ 10” 
U Unsigned 0<n<10* 


The formats of packed decimal integers are as follows: 
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)di{ dz]... | ap] s- Format for packed signed decimal digits 


K—4 (p+1) bits—>| 


Pat} a2]... | dp] Format for packed unsigned decimal digits 
p= =4.p bits 


Examples of Decimal Integers 


The source language and the associated stored value for the various types of decimal integers 
are given in the following examples: 


Stored Value 


Source language (hexadecimal) 
P°125’ 125B 
—P'99436’ 9943 6D00 
U'125’ 1250 
U'99436’ 9943 6000 
L‘125’ 2B31 3235 
—L‘'99436’ 2D39 3934 3336 
T125’ 3132 352B 
—T‘99436’ 3939 3433 362D 
0*125’ 3132 4530 
—-0'99436’ 3939 3433 4F30 
ee O'20’ 327B 

( . —O*20’ 327D 

N‘125’ 3132 3530 


FIXED-POINT CONSTANTS 


A fixed-point constant is written as a decimal number with an associated scale factor and an 
optional precision field. When the resultant value is stored in memory, a fixed-point constant 
appears as a signed integer with negative values in two’s complement form. The scale factor (s) 
gives the location of the implied binary point in the stored constant. A positive scale factor 
means that the point is situated s bits to the left of the rightmost bit stored in memory. A 
negative scale factor means that the point is situated s bits to the right of the rightmost bit 
stored in memory. Thus, the true value of a fixed point binary number may be calculated by 
multiplying its integer representation by 27°. 

The two formats for writing fixed-point constants are, as follows: 


Format 1 


"| ia "| 
B s SINGLE PRECISION 
[i] £ 
Format 2 


"| | ( "| \ 
B {[r, S SINGLE OR DOUBLE 


—} (il —| / PRECISION 
+ 
Specifies the sign of the constant. The + sign may be omitted. 
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i | | 
Specifies the integer part of the decimal number. 


Specifies the fractional part of the decimal number. 


Specifies the precision of the constant,0<r<31. 
+|s 
Specifies the value and sign of the scale factor. 
Format 1 has an implied precision of 15 bits. The value of a fixed-point constant must fall 
within the range 
2-s<|R|<25*-s 
where R is the value of the decimal number. 
Fixed-point constants are stored as aligned signed two’s complement binary numbers; that is 
they occupy one word if they are single precision and two words if they are double precision. The 


assumed binary point is located s bits to the left of the rightmost bit if the scale factor is positive, 
and —s bits to the right of the rightmost bit when the scale factor is negative. 


The following examples illustrate how to specify fixed-point constants and show the 
hexadecimal representations of the resultant values in memory. 


Source Language Stored Value 
2.5B4 0028 
2.5B8 0280 
65536B-15 0002 
65536B-7 0200 
—2.5B8 FD80 
—65536B-15 FFFE 
262144B(20,0) 0004 0000 
262144B(20,—7) 0000 0800 
262144B(i5,—7) 0800 
—262144B(20,0) FFFC 0000 
—262144B(20,—7) FFFF F800 


FLOATING-POINT CONSTANTS 


The assembly language provides a convenient method with which you can write a decimal 
number and have the Assembler convert it into floating-point format. (See Section 1 for a 
description of floating-point data.) 


There are three formats for floating-point constants: 


Format 1 


i | | i[t] | | 
SHORT PRECISION 
lilt 


Format 2 
Bitane 
+E c SHORT PRECISION 


ik: 
Format 3 


“Mee bl: 
D c DOUBLE PRECISION 


Specifies the sign of the constant. The + sign may be omitted if desired. 


ELEMENTS OF , | ae 
ASSEMBLY LANGUAGE 2-10 CBO7 


Specifies the integer part of a decimal number. 


f 

Specifies the fractional part of a decimal number. 
E 

Indicates that a short-precision floating-point representation is desired. 
D 


Indicates that a double-precision floating-point representation is desired. 
[+e 
Expresses the power of 10 by which the coded decimal number should be multiplied to 
produce the value wanted. The + sign may be omitted if desired. 
Note: 
If the decimal point is omitted, the number is assumed to be an integer. 


The absolute value of a floating-point constant must be greater than or equal to 2~™ 
(approximately 5.3976 X 10-”) and less than 2~*” (approximately 7.2370 X 10”). 


Nomnalization 


Floating-point constants are stored as normalized hexadecimal floating-point numbers witha 
7-bit excess 64 power-of-16 characteristic and a 25-bit or 57-bit signed magnitude mantissa. A 
normalized floating-point number has a nonzero high-order hexadecimal fraction digit. If one or 
more high-order fraction digits are zero, the number is said to be unnormalized. Normalization 
consists of shifting the fraction left until the high-order hexadecimal digit is nonzero and 
reducing the characteristic by the number of hexadecimal digits shifted. 


Examples 


The following examples illustrate how to specify floating-point constants and show the 
hexadecimal representations of the resultant values in memory. You can determine sign, 
characteristic, and mantissa of the resulting floating-point numbers by dividing the 
hexadecimal representations into parts according to the patterns described in Section 1. 


Source Language Stored Value 
—5 8080 0000 
0.5E12 9474 6A52 
0.5D12 9474 6A52 8800 0000 
—0.5D12 9574 6A52 8800 0000 
6.665039063E — 2 8011 1000 
—6.665039063E—2 8111 1000 


EXPRESSIONS 


Expressions are combinations of symbolic names and constants used as operands within 
Assembler control and assembly language (machine) instructions. Expressions can represent 
locations (internal, external, or common), values, and addresses. Components of an expression 
can be joined by various functions and arithmetic operators, as follows: 


Arithmetic Operator Meaning 


+ Addition (or Unary +) 

= Subtraction (or Unary —) 

a Multiplication 

/ Division 

Boolean Function Meaning 

AND Conjunction of argumentl and argument2 

OR Inclusive disjunction of argumentl and argument2 

XOR Exclusive disjunction of argumenti and argument2 

NOT Negation of argument1 | 
ELEMENTS OF 
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Shift Function Meaning 


ALS | Arithmetic left shift of argument1 
by argumentz2 bits 

ARS Arithmetic right shift of argument1 
by argument2 bits 

LLS Logical left shift of argument1 
by argument2 bits | : 

LRS Logical right shift of argumentl 


by argument2 bits 


Arithmetic Function Meaning 
MOD Remainder after division when argument1 
is divided by argument2 


General Format of a Function: 
function-name (argument 1, argument 2) 


NOTE: The Boolean NOT function has only one argument. 


When a value is operated upon by an arithmetic operator or function or by an arithmetic shift 
function the value is considered to be a 16-bit signed (two’s complement) binary integer. When a 
value is operated upon by a Boolean or logical shift function the value is considered to be a 16-bit 
bit string. You must ensure that the results of a Boolean or shift operation will be meaningful 
when subsequently interpreted as an integer value by the Assembler. The results of each 
computation must be within the allowable range of integer dimensionless values. The range is 
from -32768 to +32767. 


The shift functions must satisfy the conditions specified below or else the function will not be 
performed and the operation will be flagged as an error condition. 


ALS Oxargument2<15 
ARS 0<argument2<15 
LLS and LRS O<argument2<15 


Argument2 in the arithmetic function MOD must not equal 0. If this condition is not satisfied, 
an error condition is flagged and the function is performed as if argumentz2 is equal 1. 


The arguments in all arithmetic operations and functions must be binary integers. 


To use a function within an expression you write the function name followed by its operands, 
enclosed in parentheses and separated by a comma; e.g., AND (TAG1,TAG2). 


Below are examples of functions: 


VALI EQU X‘100’ 

VAL2 EQU X‘10F’ 

VAL3 EQU 3 

LOCI EKQU $ (at location 200 hexadecimal) 
AND 


DC <LOC1+AND(VAL1,VAL2) 

resolves to address 300 hexadecimal 
OR 

DC <LOC1+OR(VAL1, VAL2) 

resolves to address 30F hexadecimal 
-~XOR 

DC <LOC1+XOR(VALI1,VAL2) 

resolves to address 20F hexadecimal 
NOT 

VAL4 EQU NOT(VAL2) | 

resolves to value FEFO hexadecimal 

VAL5 EQU ALS(VALI,VAL3) 

resolves to value 800 hexadecimal 


ELEMENTS OF 
ASSEMBLY LANGUAGE 2-12 CBO07 


ARS 
VAL6 EQU ARS(VAL1,VAL3) 
resolves to value 20 hexadecimal 


LLS 
VAL7 EQU LLS(VAL2,12) 
resolves to value F000 hexadecimal 


LRS 
VAL8 EQU LRS(VAL2,VAL3) 
resolves to value 21 hexadecimal 


MOD 

VALI EQU MOD(VAL2,VAHL1) 

resolves to value F hexadecimal 
EVALUATING EXPRESSIONS 

Within an expression, evaluation proceeds from left to right on a same level of inclusiveness 
until a higher level is reached. The levels of hierarchy are: 

1. All functions 

2. Unary plus and minus 

3. Multiplication and division 

4, Addition and subtraction 


Parentheses can be used to change the evaluation order. Each lesser inclusive set of 
parentheses is a higher hierarchy level. 


LOCATION AND VALUE EXPRESSIONS 


The Assembler permits expressions to be used to specify values and locations. Internal and 
external value expressions denote a computation to be performed by the Assembler and produce 
integer dimensionless values. 

A location expression denotes a computation of an address that can be internal to the 
referencing program, in a separately assembled program (i.e., external to the referencing 
program), or in a common memory block. 


VALUE EXPRESSIONS 


Value expressions are used to express computations to be done by the Assembler. There are 
two types of value expressions: 
e Internal value expressions — Refer only to values that are defined within the referencing 
program. 
e External value expressions — Refer to one value defined in an external program and may 
refer to elements within the referencing program. 


Internal Value Expressions 


An internal value expression, which produces an integer dimensionless value, may be written 
as a single factor or as a sum-of-products algebraic expression. The product portion consists of 
two or more factors to be multiplied or divided as indicated by the* or / operators, preceding the 
multiplier or divisor factor. In addition, each factor can be preceded by a unary plus (+) or minus 
(—) operator. 


Each factor of the expression must be one of the following items: 


(int-val-expression) 

binary integer 

string constant 

int-val-label 

assembler function 

Commercial Processor edit function 


ELEMENTS OF 
ASSEMBLY LANGUAGE | 2-13 CBO07 


The sum portion of the algebraic expression consists of two terms to be added or subtracted as 
indicated by the + or — operator preceding the addend or subtrahend term. In addition, each 
term can be preceded by a unary plus (+) or minus (—) operator. 


Each sum of an internal value expression must take one of the following forms: 


binary-integer 
string-constant 


int-val-exp + assembler-function 
= Commercial-Processor-edit-function 


int-val-label 
product (or quotient) of these terms 
The difference between two internal locations. 
The difference between two common locations within the same common block 


The following examples illustrate internal value expressions. In these examples, labels of the 
form VALc are internal value labels, labels of the form LOCc are internal location labels, and 
labels of the form COMMc are common location labels. 


Example 1: 
X‘34F0’+(VAL8— (VALB/(X°E4™2))) 


In this example, the expression is evaluated as follows: 

1. The product of X‘E4*2 is calculated. 

2. The value associated with VALB is divided by the product of step 1, above. 

3. The quotient of step 2, above, is subtracted from the value associated with VAL8. 
4. The difference calculated in step 3, above, is added to X‘34F0’ 


Example 2: | 
B‘'11110110’+(COMM1—COMM2)/2* (54+ VALF-(LOCA—LOCB)) 


The expression in example 2 is evaluated as follows: 

The difference between COMM1 and COMM2 is calculated. 

The result of step 1, above, is divided by 2. 

The sum of 54 and value associated with VALF is calculated. 

The difference between LOCA and LOCB is calculated. 

The result of step 4, above, is subtracted from the result of step 3. 
The quotient calculated in step 2 is multiplied by the result of step 5. 


The bit string constant B‘11110110’ is padded to occupy a full word and added to the result 
of step 6. 


oe 


External Value Expressions 


An external value expression references one value defined in another program (declared by an 
XVAL statement in the referencing program) and may reference additional elements defined in 
the referencing program. An external value expression must take one of the following forms: 


binary-integer 
ext-val-label ee 
[+] ext-val-exp +} Int-val-labe 
assembler-function 
(ext-val-exp) 


Commercial-Processor-edit-function 
(int-val-exp) 


ext-val-label 
int-val-exp + 
(ext-val-exp) 
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The following example illustrates external value expressions. In this example, VALZ is an 
internal value and VALEX is an external value. 


Example: 
18 + VALEX + VALZ 
1. The two internal values are added together, i.e., 18 + VALZ 
2. The value 18 + VALZ is the offset associated with the external value, VALEX. 


LOCATION EXPRESSIONS 


Location expressions are used to express address computations to be done by the Assembler. 
There are three types of location expressions: 


e Internal location expressions — Refer only to locations that are defined within the 
referencing program. 


e External location expressions — Refer only to locations defined in an external program and 
may refer to elements within the referencing program. 


e Common location expressions — Refer only to locations within common blocks and may 
refer to other elements within the referencing program. 


Each of the above types of location expressions produces a memory address. 
Internal Location Expressions 


Internal location expressions, which produce a memory address based upon a computation 
using only internal elements, must take one of the following forms: 
binary integer 
string constant 
assembler function 
Commercial-Processor-edit-function { 
int-val-label 
(int-val-exp) 


int-loc-label 
int-val-exp + invtocexp | 

$ 
In the previous form, the $ is valid only if the Assembler’s location counter type attribute is 
internal when the expression is processed. 


int-loc-exp{ +} 


The following example illustrates internal location expressions. In this example, labels of the 
form LOCc are internal location labels. 


Example: 


(LOC3-LOCD)+ X‘30F2’+ LOCA 
The expression in this example is evaluated as follows: 


1. The address associated with LOCD is subtracted from the address associated with LOC3 
yielding an internal value. 


2. X‘30F2’ is added to the result of step 1 yielding another internal value. 
3. The address associated with LOCA is added to the result of step 2 yielding an internal 


location as the final result. 
External Location Expressions 


External location expressions, which produce a memory address based upon a computation 
using external location labels and internal values, must take one of the following forms: 
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binary integer 
string constant 

ext-loc-exp {+} < assembler function 
Commercial-Processor-edit-function 
int-val-label 
(int-val-exp) 


Edel ase ext-loc-label 


(ext-loc-exp) 


The following example illustrates an external location expression. In the example, labels of 
the form XLOCc are external location labels and labels of the form VALc are internal value 
labels. 


Example: 
((VAL1+ VALA)+ XLOC2)+ X‘2A22’ 


This sample expression is evaluated as follows: 

1. The values associated with VAL1 and VALA are added together. 
2. The offset associated with XLOC2 is added to the result of step 1. 
3. X‘2A22’ is added to the result of step 2. 


Common Location Expressions 


Common location expressions, which produce a memory address based upon a computation 
using one or more locations within a common block and internal values, must take one the 
— following forms: 


binary integer 

string constant 

assembler function 
Commercial-Processor-edit-function 
int-val-label 

(int-val-exp) 


common-loc-exp {+ } 


common-loc-label 
int-val-exp + 4 (common-loc-exp) 


$ 


In the previous form the § is valid only if the Assembler’s location counter type attribute is 
common when the expression is processed. 


A memory address referring to a common block is represented by the name of the common 
block and an optional offset from the beginning of that common block. 


The following example illustrates a common location expression. In the example COMMc is a 
common location label and labels of the form VALc are internal value labels. 


Example: 
((COMMA+42)—(COMMA-+ 80))— VAL2)*2+ X°1000’+COMMB 


The expression in this example is evaluated as follows: 

1. The difference between COMMA+ 42 and COMMA+ 80 is calculated. 
The value associated with VAL2 is subtracted from the result of step 1. 
The result of step 2 is multiplied by 2. 

X‘1000’ is added to the result of the calculation in step 3. 


The offset associated with COMMB is added to the result of step 4. This offset is then 
associated with the name of the common block containing COMMB to complete the 
evaluation of this expression. | 


a ea ad 
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ADDRESS EXPRESSIONS 


An address expression specifies the addressing form used in an instruction. It contains special 
character identifiers that are assembled into corresponding object code to control run-time 
address development processes such as indirection and indexing. 


The various forms of address expressions permitted by the Assembler are described in detail 
in Section 5 (see “Addressing Techniques”). 


REFERENCES 


References are the use of symbolic names as labels in assembly statements to refer to locations 
or values. 


The employment of references is dependent upon two conditions: 
1. The resolution of labels by the two-pass Assembler. ” 
2. The position of the referencing statement within the body of the program. 


Asimple rule may always be applied to determine the validity of a reference: the reference toa 
label is legitimate if during the second assembly pass, at the point in the program where the 
referencing statement is positioned, the value of the label being referred to, has been defined. 


References may be made either forward or backward. A forward reference is a reference to a 
label that is defined after the referencing statement. A backward reference is a reference to a 
label defined in a statement before the referencing statement. 


Further, forward or backward references may be categorized as either simple or complex. A 
simple reference is a forward or backward reference to a label that is directly defined by the 
referenced statement. A complex reference is a forward or backward reference to a label defined 
by an equate (EQU) statement that in turn makes at least one additional reference. 


Example: 
References 
A DC 13 
G DC 7 


LDR $R1,A (Valid simple backward reference) 
LDB- $B1,X (Valid simple forward reference) 


WEQU E 
B EQU G 
LDR $R2,E (Invalid complex forward reference (label E not defined at this 


point)) 

LDR  $R3,W (Invalid complex backward reference (label W can never be 
defined in a two-pass assembly)) 

E EQU D 

LDR $R4,E (Valid complex backward reference (label E has been 
defined at this point)) 

LDR $R5,C (Valid complex forward reference (label C has been 
defined in the first assembly pass)) 


C EQU' B 
D RESV 1 
X DC 3 


Restrictions that apply to references are as follows: 
1. All forward references to a label defined by a complex equate statement are invalid. 


2. A forward reference in an origin (ORG) common (COMM) or a local common (LCOMM) 
statement is invalid. 

3. A forward reference in the first operand of a reserve (RESV) or conditional assembly 
control IFxx statement is invalid. 

4. A complex reference involving one or more intermediary equate statements making a 
forward reference is invalid. 


“An assembly pass is a complete read of the source program. 
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Section 3 


Programming 
Considerations 


Before writing an assembly language source program, you should take into consideration 
both features and constraints inherent in the design of the Assembler and the system. This 
section describes the considerations that should be made, as well as the various rules that must 
be followed, when coding your source program. These include: 


e Rules of formatting your source language statements 
e Ordering of statements in an assembly language program 
e Rules governing the calling of system services and external procedures 


e Utility programs that supplement assembly language source programs 


ASSEMBLY LANGUAGE SOURCE STATEMENT FORMATS 


As mentioned in Section 2, the assembly language consists of Assembler controlling 
statements and assembly language (operational) instructions. Assembly language source code 
must be submitted to the Assembler in a recognizable format so that it can be interpreted 
accurately. Therefore, when coding assembly language source statements, you must conform to 
the following formatting conventions: 


Column 1 
A A A | 
labelA opcode J Aoperand 2 ,operand ,operand| ...| [Acomments] 
linenumA A ; : 


linenum-labelA 


The semicolon (;) indicates to the Assembler that the next operand is contained in the next 
sequential source line (i.e., the continuation statement), which has the following format: 


Column 1 — 


[linenum][A]loperand | operand| . : a) [Acomments] 
A | 


In addition to comments being included on individual assembly language source 
statements, comment statements, which have the following format, can be included in the 
source language program. 


Column 1 


oe 
/ 


linenum* 
linenum/ 


comments 


The asterisk (*) indicates that the comment line is to be included in the listing wherever it is 
included in the source language program. The slash (/) indicates that the Assembler is to cause 
the printer is to skip to the top of the next page of the listing before printing the comment. 
Printing of lines can be overridden by the inclusion of an NLST Assembler control statement in 
the source code (see Section 4). 

_ In the above formats, label is any user-specified tag, linenum is any user-specified line 
number, linenum-label indicates a line number followed by a label with no intervening spaces, 
opcode and operand indicate the required assembly language fields described in Sections 4 
through 7, and blank (A) indicates that one or more blanks or horizontal tab characters must be 
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coded. Any number of blanks and/or horizontal tab characters can follow a comma (,). A line 
number is an unsigned decimal integer of any length. Line numbers are ignored by the 
Assembler. 


Except for the order in which information must be supplied, the source language format is a 
free-form. However, it is suggested that you establish a fixed format for coding source 
statements (e.g., always starting op codes in the eleventh position and operands in the twenty- 
first) so that you can read your listing more easily. 


ORDER OF STATEMENTS IN SOURCE PROGRAM 


With the following exceptions, Assembler control statements can be entered in any order: 
1. The TITLE statement must be the first statement in the source program. . 


2. The END statement must be the last statement in the source program. 


CALLING SYSTEM SERVICES 


- System services (e.g., the Task Manager) can be requested through the use of monitor service 
calls and macro calls. For information concerning requests for system services see the System 
Services Macro Calls manual. 


CALLING EXTERNAL PROCEDURES 


Procedures that are assembled separately from the invoking procedure are designated 
external procedures. 


The individual elements of data passed to an external procedure are known asarguments. The 
_ external procedure interprets these arguments as parameters; to the external procedure, the 
order of the parameters is the same as the order of the arguments passed from the invoking 
procedure. 


External procedures can be requested by coding request sequences such as the following: 


LAB $B7,arglist 
LNJ $B5,<entry 


In the above sequence, ‘entry’ is the external label of the appropriate entry point of the called 
(external) procedure, and ‘arglist’ is the argument list to be passed to the called (external) 
procedure. 


Alternatively, you could use a request such as the following: 
CALL entry,argl,arg2,... 


This request is similar to the preceding sequence except that the CALL Assembler control 
statement automatically generates the argument list, loads its address into B7, and sets the 
return address in B5. As a result, when the external procedure completes its work, control is 
returned to the next sequential instruction or statement in the calling program. 


ALTERNATE METHOD OF HANDLING 
INPUT/OUTPUT AND FILE MANIPULATION 


Input/output and file manipulation can be accomplished by writing Assembler routines or by 
using monitor service requests. Details concerning monitor service requests are contained in 
the System Service Macro Calls manual. 


ASSEMBLER 


The Assembler processes source statements written in assembly language, translates the 
statements into object code, and produces a listing of the source program together with its 
associated assembly information. | 


The Assembler accepts arguments that allow you to control its operation in various ways. 
Detailed information about the Assembler and its arguments can be found in the Program 
Preparation manual. 
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CROSS-REFERENCE LISTING 


When a source program is assembled, the Assembler produces a cross-reference listing, if the 
proper option is specified in the command invoking the Assembler. This list itemizes all labels 
and symbols in the source module and flags labels that are undefined or defined more than once. 


SAF/LAF CONSIDERATIONS 


For execution in a Mod 400 systems, assembly language programs may be in either the long 
address form (LAF) or the short address form (SAF). In some circumstances it may be desirable 
to create an assembly language program that can be executed in both SAF and LAF configura- 
tions. For instructions on writing such a program, see Program Preparation manual. 


REENTRANCY CONSIDERATIONS 


A program is defined as reentrant, if a single copy of the code portion of a bound unit can be 
simultaneously executed by several tasks, which may be inthe same task group or different task 
groups. GCOS 6 software is designed to facilitate the writing of reentrant programs. See 
Program Preparation manual. 
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Section 4 


Assembler Control Statements 


Every assembly language program must contain, in addition to the assembly language 
instructions, a set of instructions that tells the Assembler about the program. These Assembler 
control statements, most of which are not assembled into the object text, provide information to 
the Assembler for: 


e Controlling the assembly of the program 


e Controlling the listing of assembly language instructions and Assembler control state- 
ments 


e Defining constants to be used by the program 

e Defining main memory storage and/or work areas 

e Defining symbols 

e Linking programs 

e Conditionalizing the assembly of various parts of a program 

Assembler control statements must be coded as described in Section 3 (see “Assembly 
Language Source Statement Formats”), except that some explicitly prohibit the use of labels. 
For that reason, each Assembler control statement described in this section identifies labels 


where they are required or permitted; when not shown under “Source Language Format” labels 
are not allow 


ASSEMBLY-CONTROLLING STATEMENTS 


Assembly-controlling statements tell the Assembler where the beginning and end of each 
program are; they also set the Assembler’s location counter. 


The following statements are the assembly-controlling subset of Assembler control state- 
ments: 


e BORG 
e END 
e ORG 
e TITLE 


LIST-CONTROLLING STATEMENTS 

List-controlling statements control the listing of an assembly language source program via a 
printer, disk, or user’s terminal. The following statements are available to provide this function: 
function: 

e CLST 

e LIST 

e NLST 
DATA-DEFINING STATEMENTS 

Data-defining statements are required to define data used in the program. The Assembler 
assigns this data to memory locations at the exact point at which they are defined. The following 
statements are the data-defining subset of the Assembler control statements: 

e ARGLST 

e BTEXT 

e DC 

e PTRAY 

e TEXT 
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STORAGE-ALLOCATION STATEMENTS 


Storage-allocation statements direct the Assembler to make areas of memory available for 
use as storage and/or work space. This subset of the Assembler control statements consists of the 
following statements: | 


e COMM 
e LCOMM 
e RESV 


SYMBOL-DEFINING STATEMENTS 


Symbol-defining statements assign specific meanings to given symbolic names; they also may 
identify symbolic names defined outside the program but used within it. The assembler control 
statements provided to support the symbol-defining function are: 


e EQU 
° XLOC 
e XVAL 


PROGRAM-LINKING STATEMENTS 


Large programs are often written as several separately assembled or compiled smaller 
programs. At execution time, it is necessary for these separately assembled or compiled prog- 
rams to establish communication links. The linking processes (see the Program Execution and 
Checkout manual) use information from the following program-linking statements to assign 
final addresses and/or data values to be used by the separately assembled or compiled proce- 
dures (i.e., programs) common to a single bound unit: 


e CALL 
e CALL2 
e CTRL 
e EDEF 
e XDEF 


CONDITIONAL ASSEMBLY-CONTROL STATEMENTS 


Conditional assembly-control statements allow a comprehensive source program to be writ- 
ten to cover many situations. Then, during assembly, they can direct the Assembler to assemble 
or inhibit assembly of particular assembly language instructions (and/or groups of assembly 
language instructions) when specific conditions occur. The following statements provide the 
Assembler with information for conditional assembly: 


e FAIL 
e IF 
e NULL 


OPERATION CODE-DEFINING STATEMENT 
e DEFGEN 


ASSEMBLER CONTROL STATEMENTS 


The remainder of this section lists and describes the Assembler control statements in . 


alphabetical order. The descriptions include the expanded name of the statement, its source 
language format (including the label field, where it is permitted or required), a detailed 
description of what the statement does, and a description of each of its operands. 


Information about the various symbolic names identified in the statements is contained in 
_ Section 2. 
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ARGLST 


ARGLST 


Instruction: 


Create argument list 


Source Language Format: 
[label JAARGLSTAarg!1 [,arg2]... 


Description: 
Creates a word containing an arbitrary constant whose bits 9 through 15 specify the value 
(M*$AF+1), where M is the number of arguments. This arbitrary constant is followed by the 
relocatable address of each argument in the statement. The relocatable addresses are the same 
as though the following DC statement was coded after the arbitrary constant. 

[label]JADCA <argument ,[,<argument ,]... 
If the Assembler is invoked with the SLIC argument, this instruction will also identify the 
resulting object text as being an argument list. The SLIC (SAF/LAF Independent Code) argu- 
ment must be used if compilation units produced by the Assembler is to run in both SAF and 
LAF configurations. 
The maximum number of arguments that can be specified in an ARGLST instruction is 31. The 
ARGLST instruction facilitates the writing of reentrant programs by allowing the arguments to 
be separated (i.e., placed in a different segmented address space) from the calling statement. 
(See the Program Preparation manual for instructions on writing reentrant programs.) 
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BORG | 


BORG 


Instruction: 
Byte Origin 


Source Language Format: 


common-location-expression 
[label JAORGA 


internal-location-expression 


Description: 


Sets the byte indicator to the odd (i.e., right) byte and assigns the attributes and value of the 
operand to the location counter (1.e., if the operand is a common location expression, the location 
counter type attribute is set to common. If the operand is an internal location expression, the 
location counter type attribute is internal). The initial value ofthe Assembler’s location counter 
is internal location 0. The initial value of the Assembler’s byte indicator is the even (i.e., left) 
byte. 


The label field and operands have the following meanings: 


label 
If specified, the label will be assigned the value contained in the location counter before the 
new value is assigned to the location counter. 


common-location-expression 
Sets the location counter type attribute to common and sets the location counter value to the 
specified offset in the common block. Temporary labels cannot be defined while the location 
counter has the common attribute. 


internal-location-expression 
Sets the location counter type attribute to internal and sets the location counter to the 
specified value of the location expression (see Section 2 for a description of common location 
and internal location expressions). Regardless of the type attribute of the expression 
specified in the operand, it must not contain a forward reference. 
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BTEXT 


BTEXT 


Instruction: 


Allocate space for text 


Source Language Format: 


llabel]ABTEXT A as Seamed i ee Ll] 


Commercial-Processor- , Commercial-Processor- 


Pan edit-function edit-function 
Description: 


Causes the Assembler to allocate the binary representation of the successive string constants, 
and/or edit functions concatenated into the fewest number of bytes (i.e., packed). The Assembler 
inserts “slack bits” (0’s) between successive operands as necessary. Each ASCII string constant 
or edit function begins at a bit position that is a multiple of 8; each hexadecimal string constant 
begins at a bit position that is a multiple of 4; bit string constants have no slack bits inserted. 


If the last byte occupied by the concatenated string is not exactly full, the remaining bits are 
zero-filled. The first byte of the concatenated string is allocated at the object memory byte 
location indicated by the Assembler’s location counter and byte indicator. Following processing 
of the Byte Text statement, the values of the location counter and byte indicator indicate the 
object memory byte location of the first byte following the concatenated string allocated by the 
BTEXT statement. 


NOTE: When the byte indicator indicates the odd (right) byte, BTEXT is the only memory- 
allocating assembly language statement allowed. 
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CALL 


CALL 


Instruction: 


Call external procedure 


Source Language Format: 
[label ]JACALLA[obj-mod-name. Jentry[,arg1 [,...,arg31]] 


Description: 


Initiates a transfer of control to a specified external subroutine and causes that subroutine to be 
linked with the calling procedure. 


The operands have the following meanings: 
obj-mod-name. 


If specified, it is the object text name of the external procedure; otherwise, it is assumed to 
have the same name as the entry point (entry). 


entry 
Identifies the entry point in the procedure to which control is transferred. 
argl,....arg31 


If specified, provides addresses of arguments to be passed. The maximum number of arguments 
is 31. 


If the argument list is not included, the CALL statement is broken down by the Assembler as 
follows: | 


CTRL LINK obj-mod-name 
XLOC _ entry 

LAB $B7,= 1 

LNJ $B5,<entry 


If the argument list is included, the CALL statement is broken down as follows: 


CTRL LINK obj-mod-name 
XLOC entry 

LAB $B7,$+$AF+3 

LNJ $B5,<entry 

B >$+n*$AF+1 

DC <arg1[,<arg2]... 


The entry name in the XLOC statement shown in the breakdowns is not entered into the 
Assembler’s symbol table, and ceases to exist after the LNJ instruction is executed. The term n, 
shown in the B-instruction in the second breakdown is an internally computed constant equal to 
the number of arguments specified in the CALL statement; this makes it possible for the 
Assembler to branch around the DC statement(s). 


If the assembler is invoked with the “SLIC” control argument, it will identify the object unit text 
resulting from the branch and DC statements in the second breakdown as being an argument 
list. Additional information about calling external procedures may be found in the Program 
Preparation manual. 
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CALL2 


CALL2 
Instruction: 
Call external procedure. 
Source Language Format: 
[label ]ACALL2A[obj-mod-name. Jentry,address-expression 


Description: 


Initiates a transfer of control to a specified external subroutine, causes that subroutine to be 
linked with the calling procedure, and generates the address of a list of arguments to be made 


_ available to the called subroutine. The argument list is normally generated by the ARGLST 


statement which is previously described in this section. 
The operands have the following meanings: 
obj-mod-name. 
If specified, it is the object text name of the external procedure; otherwise, it is assumed to 
have the same name as the entry point (entry). 
entry 
Identifies the entry point in the procedure to which control is transferred. 
address-expression 
Generates the address of the argument list. The address expression must be one of the forms 
valid in a LAB instruction. 
The CALL2 statement is broken down as follows: 


CTRL LINK obj-mod-name 
XLOC _ entry 

LAB $B7,address-expression 
LNJ $B5,<entry 


The entry name in the XLOC statement shown in the breakdown is not entered into the 
Assembler’s symbol table and ceases to exist after the LNJ instruction is assembled. 
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CLST 


CLST 


Instruction: 


Conditional Listing 


Source Language Format: 
[label ]ACLSTAint-val-expression 


Description: 


If the internal value expression is > 0, the CLST statement does not appear in the assembly 
listing. If the internal value expression is < 0, the CLST statement appears in the assembly 
listing with an error flag (Z-conditional assembly error). The comment field may be used to 
provide additional information concerning the error. The label of a CLST statement is not 
entered into the Assembler’s symbol table. 
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COMM 


COMM 


Instruction: 


Define common block 


Source Language Format: 
[label ]ACOMMAint-val-exp 


Description: 


Allows you to define a common block compatible with FORTRAN common areas. 
The label field and operands have the following meanings: 


label 
If specified, the common area is given that name; otherwise, it is unlabeled (i.e., blank) 
common, and is given the symbolic name $COMM (by implication). 


NOTE: Temporary label definition is prohibited when ORG has been performed in a common 
block. 


int-val-exp 
Specifies the size (in words) of the common area. The Linker (see the Program Execution and 
Checkout manual) assigns all common blocks with the same name to the same memory area 
regardless of the memory location in the source program at which they are defined (i.e., the 
COMM statement does not alter the Assembler’s location counter). 


int-val-exp is an internal value expression (see Section 2), and must be defined prior to the 
occurrence of this COMM statement. It must not contain a forward reference. Elements ina 
common block can be referenced by the name of the common block plus the element’s 
displacement within the block. 
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CTRL 


CTRL “™. 
Instruction: ae 
Pass control information to Linker 
Source Language Format: 

ACTRLAlinker-directive(s) 
Description: 


Provides a method of passing Linker directives from the source program to the Linker (see the 
Program Execution and Checkout manual for a description of the Linker). 


The operand has the following meaning: 


linker-directive(s) | 
Specifies data to be passed verbatim to the Linker as part of the program’s object text (i.e., it 
is not verified by the Assembler). 
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DC 


DC 


Instruction: 


Define Constants 


Source Language Format: 
[labelJADCAoperand ,[,operand ,]... 


Description: 


Defines data to be included in the object text. The Assembler interprets the constants, converts 
them to the proper binary representation, and assigns them to successive memory locations at 
the exact point at which the DC statement appears in the source program. 


The operands of the DC statement must conform to one of the following formats: 


| Format 1: 


location-expression 
<  ){+| temporary-label 
Causes a 1- or 2-word address pointer, as appropriate to be allocated. 
Format 2: 

location-expression 

{+} temporary-label 
Causes a 1-word displacement from the current location to the specified location to be 
allocated. 


Format 3: 
(e.g., int-loc-expression produces the same results as int-loc-expression — $) 


[=1{ 


string-constant 
decimal-integer-constant 


Constants are padded if necessary to make an integral number of words; the padded value is 
allocated to memory. ASCII string constants are padded by appending a space. 
Hexadecimal and bit string constants and decimal integer constants are padded by a 
sufficient number of zero bits. 


Format 4: 
[=] int-val-expression 
ext-val-expression 
Causes a 1-word binary integer to be allocated. 
Format 5: 
[=] fixed-point-constant 


Causes a 1- or 2-word fixed point value to be allocated. Ifthe precision of the constant is from 
1 through 15, one word is allocated; if the precision is from 16 through 31, two words are 
allocated. 


Format 6: 
[=] floating-point-constant 
Single precision floating-point constants cause a 2-word value to be allocated. 
Double precision floating-point constants cause a 4-word value to be allocated. 
Floating-point constants are described in Section 2. 

Format 7: 
[=] Commercial-Processor-data-descriptor 
Causes the allocation of a 2-word data descriptor. 
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DEFGEN 


Format 8: 
complex-label 
Processed as described above for a format 1, 4, or 5 operand, depending on whether the label 
has been equated to a direct IMA address expression, an external value IMO address 
expression, an internal value IMO address expression, a short fixed point constant IMO 
address expression, or a Commercial Processor data descriptor funtion, respectively. A 
complex type label equated to any other address expression is illegal. 

The number of operands is limited only in that the address space of a single program is restricted 

to relative locations 0 through 32767. 

DEFGEN 


Instruction: 


Define generic operation code 


Source Language Format: 
label ADEFGENAint-val-expression 


Description: 


Allows the user to create operation codes that specify generic instructions 
The name (specified by label) is declared to be a one-word generic instruction (specified by 
int-val-expression). 


The DEFGEN statement is designed for use with the Writeable Control Store. However, the 
presence of the Writeable Control Store is not essential for its use. 


The DEFGEN statement must precede any instruction that references the label. 


A Honeywell mnemonic for an assembly instruction may be specified as a label. (See 
example below.) In this case, the user defined instruction is executed whenever it 
subsequently occurs (rather than the instruction specified by the Honeywell mnemonic). 
Example: 

The assembly language instruction NOP is a one-or two-word instruction that requires an 
address expression. For a source program that uses one-word NOP’s in the same way 
throughout, the NOP may be redefined to give the appearance of a generic instruction. 
Assume a source program that repeatedly uses the following instruction: NOPA>$+2. This 
is a one-word instruction whose assembled value is OFO2. NOP can be redefined as follows 


by the DEFGEN statement and thereafter used without including an address pADEeeo 
NOP DEFGEN Z0F02’ 


NOP 
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ers 


EDEF 


EDEF 
Instruction: 
External label definition — For use with Linker and Loader 


Source Language Format: 
label-1 


AEDEFA . int-loc-exp 
label-2, [...] 


int-val-exp 
Description: 


Identifies labels to be made available to external procedures. These labels can than be referred 
to through XLOC and X VAL statements in the external procedures. The occurrence of a label in 
an EDEF statement does not define that label for use elsewhere within that program. (The label 
is not entered into the Assembler’s symbol table.) 


The operands have the following meanings: 


label-1 
Identifies a label, defined elsewhere in the source program, as an internal location label or 
internal value label (see Section 2), that can be referred to by the same name in a 
separately assembled program through an XLOC or XVAL statement. 


label-2 


int-loc-exp 
label-2, 
int-val-exp 
int-loc-exp and int-val-exp are internal location or internal value expressions, respectively, 
which are evaluated by the Assembler, with the resulting value and type being associated 


with the label. The label can be referred to by a separately assembled program through an 
XLOC or XVAL statement. 


Regardless of which form of the operands is used, the Assembler evaluates the label and 
generates a type and value attribute to be associated with the label. The results of this 
evaluation are passed to the Linker with the object text for use during the linking process 
and subsequently passed to the Loader to be included as part of the bound unit being created 
(see Program Execution and Checkout manual). 


Notes: 
1. It is not necessary for all labels identified through the EDEF statement to be 
referred to by an external program. 
2. Ifa label is not identified to an external procedure by an EDEF statement, the 
label can be identified in the bound unit at link time by the EDEF directive to 
the Linker, provided it has been defined via the XDEF statement. 


3. Ifalabel is not identified to the Linker by either the EDEF or XDEF statement, it 
may be identified to the Linker via the LDEF or VDEF Linker directive as 
appropriate. It then may be subsequently identified to the bound unit with 
the EDEF Linker directive. 
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END 


END | pe 

Instruction: 

End of program 

Source Language Format: 
AENDAprogram-name[,internal-location-expression | 


Description: 


Identifies the end of the assembly language program. Statements subsequent to this statement 
will be ignored by the Assembler. If this statement is missing, the Assembler will generate an 
END statement. | 


The operands have the following meanings: 


program-name 
Must be the same program name specified in the source program’s TITLE statement. 


internal-location-expression 
If specified, it identifies the program’s normal entry point. (See “Expressions” in Section 2 
for a description of internal location expressions.) 
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EQU 


EQU 

Instruction: 

Equate 

Source Language Format: 


location-expression 


value-expression 
address-expression 


label AEQUA 
complex-label 
identifier 
single precision fixed-point-constant 
Description: 


Assigns the value identified in the operand field, together with all of its associated attributes, to 
the label. : 


The operands have the following meanings: 


single-precision-fixed-point-constant 

location-expression 

value-expression 
The label is treated by the Assembler as the same type as the operand (see “Expressions” in 
Section 2). 


address-expression 
complex-label 
The label is treated as a complex type (see “Expressions” and “Labels” in Section 2). 
Note: : 


Complex labels cannot contain Commercial Processor address expressions. 


Complex labels cannot contain direct or indirect B6 relative plus local common block 
plus displacement addressing (see “B-relative addressing” in Section 5). 


identifier 
The label is treated as an identifier that is equivalent to this one (see “Identifiers” in 
Section 2). 
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FAIL 


FAIL 
Instruction: 
Identifies a statement that should never be assembled. 
Source Language Format: 
[labelJAFAIL 
Description: 


If the FAIL statement is assembled, an Assembler error flag (Z-conditional assembly error) is 
generated. The FAIL statement is used in conditional assemblies to ensure that the prevailing 
conditions are logically consistent. 


Ifthe statement is labeled, the label is not entered into the Assembler’s symbol table; asa result, 
it can be referred to only by a preceding IF statement. 
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IF 


IF 


Instruction: 


Conditional skip 


Source Language Format: 


OD 
P 
[label JAIF 4 [N] 1 N A int-val-expression, label 
Z, 


EV 


Description: 

If the specified condition is met, the Assembler skips subsequent statements until the label is 
encountered; otherwise, the next sequential instruction is processed. (0 is neither positive nor 
negative.) 


The opcode is interpreted as follows: 
IFP 

Skip to label if int-val-expression is positive (i.e. > 0). 
IFNP 

Skip to label if int-val-expression is not positive (i.e. < 0). 
IFN 

Skip to label if int-val-expression is negative: (i.e. < 0). 
IFNN 

Skip to label if int-val-expression is not negative (i.e. = 0). 


IFZ 
Skip to label if int-val-expression is zero. 


IFNZ 
Skip to label if int-val-expression is not zero. 


IFOD 
Skip to label if int-val-expression is odd. 


IFEV 
Skip to label if int-val-expression is even. 


The operands have the following meanings: 
int-val-expression 
Internal value expression (see “Expressions” in Section 2); forward references are not 
permitted. 
label 
Label (see “Labels” in Section 2) identifying the next statement or instruction to be 
processed by the Assembler if the condition is met. 
If a label is specified, it is not entered in the Assembler’s symbol table; as a result, it can be 
referred to only by a preceding IF statement. 
Example: 
IFNZ AND($SW,Z’4000’), SKIPIT 


External Switch 1 is checked. If it is set the Assembler skips the subsequent statements 
until the label SKIPIT is encountered. If External Switch 1 is not set, the Assembler goes to 
the next lie of assembly code. This is an example of varying an assembly.procedure without 
altering the assembly language source program. 
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LCOMM 


LCOMM 
Instruction: 


Define local common block 


Source Language Format: 
labelALCOMMAint-val-exp 


Description: 


Provides a way for a block of data local to a program to be allocated not by the Assembler, but by 
the Linker using standard linking procedures for allocating common blocks. The data allocated 
by use of the LCOMM statement is not shared. 


The label field and operands have the following meanings 


label 
The name of the common area. 
NOTE: LCOMM does not allow a temporary label to be specified. 

int-val-exp 
Specifies the size (in words) of the common area. The Linker (see the Program Execution and 
Checkout manual) assigns all common blocks with the same name to the same memory area 
regardless of the memory location in the source program at which they are defined (i.e., the 
LCOMM statement does not alter the Assembler’s location counter). In the case of a local 


common block, the Linker removes the name of the local common block from its symbol 
table after it has linked the program which defined the local common block. 


int-val-exp is an internal value expression (see Section 1), and must be defined prior to the 
occurrence of this LCOMM statement. It must not contain a forward reference. Elements in 
a common block can be referenced by the name of the common block plus the element’s 
displacement within the block. 
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LIST 


LIST 
Instruction: 
List following source statements 
Source Language Format: 
ALIST 


Description: 


Causes subsequent assembly language instructions and Assembler control statements to be 
included on the assembly listing. Listing of the statements continues until the end of the 
program or until an NLST Assembler control statement is encountered. 
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NLST 


NLST | ite, 
Instruction: | 
Inhibit listing of following source statements 
Source Language Format: 

ANLST | a 
Description: 


Prevents subsequent assembly language instructions and Assembler control statements from 
being included in the assembly listing. Listing of the statements continues to be inhibited until 
the end of the program or until a LIST Assembler control statement is encountered. 


This statement overrides the use of * or /comment source statements (see Section 8). 
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NULL 


( = . NULL 
Instruction: 


No effect; processing continues 


Source Language Format: 
[label JANULL 


Description: 
Has no effect on the assembly process. 


This Assembler control statement is commonly used to define a label referred to by an IF 
statement. Processing continues with the next sequential instruction. 


If the statement is labeled, the label isnot entered into the Assembler’s symbol table; asa result, 
it can be referred to only by an IF statement. 
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ORG 


ORG 

Instruction: 

Origin 

Source Language Format: 


[1 abel | AORGA common-location-expression 
internal-location-expression 


Description: 


Sets the byte indicator to the even (i.e., left) byte and assigns the attributes and value of the 
operand to the location counter (i.e., if the operand is a common location expression, the location 
counter type attribute is set to common. If the operand is an internal location expression, the 
location counter type attribute is internal). The initial value of the Assembler’s location 0. The 
initial value of the Assembler’s byte indicator is the even (i.e., left) byte. 


The label field and operands have the following meanings: 


label 
If specified, the label will be assigned the value contained in the location counter before the 
new value is assigned to the location counter. 


common-location-expression 
Sets the location counter type attribute to common and sets the location counter value to the 
specified offset in the common block. Temporary labels cannot be defined while the location 
counter has the common attribute. 


internal-location-expression 
Sets the location counter type attribute to internal and sets the location counter to the 
specified value of the location expression (see Section 2 for a description of common location 
and internal location expressions). Regardless of the type attribute of the expression 
specified in the operand, it must not contain a forward reference. 
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PTRAY 


PTRAY 


Instruction: 


Create pointer array 


Source Language Format: 
[label]JAPTRA YA location-exp1| ,location-exp2 | sen 


Description: 


Creates an array of pointers. The address of a memory word is referred to as a pointer. Pointers 
may occur at the level of machine language both as direct addresses and as indirect addresses. 


The Assembler generates the object unit code as if the statement were transformed into the 
following DC statement. 
[label]ADCA < location-exp1 [,<location-exp2] .. . 


If the Assembler is invoked with the SLIC argument, it will also identify the object unit text 
resulting from the PTRAY statement as being a pointer array. This is necessary so that in 
loading a SLIC program, the Loader will compress addresses if executing in SAF mode. 
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RESV 


RESV | | — 
Instruction: 
Reserve main memory space 
Source Language Format: 
[label JARES VA int-val-expal[,int-val-expb] 
Description: 
Reserves space in main memory for use by the bound unit as work or storage space. 


The label field and operands have the following meanings: 


label | 
If specified, the first word of the reserved area is given that name. 

int-val-expa | | | 
This is an internal value expression (see Section 2) that specifies the size (in words) of the 
reserved area. It must not contain a forward reference. 

int-val-expb | 
If specified, it is an internal value expression (see Section 2) specifying the initial value to 
which each word in the reserved area is initialized when the bound unit is loaded. If this 
operand is not specified, the contents of the reserved area are undefined. 
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TEXT 


TEXT 
Instruction: 
Allocate space for text 


Source Language Format: 


String-constant 
[label JATEXTA | Commercial Ranensishaatin: 


string-constant 
,;Commercial Processor-edit-function ea 


Description: 


Causes the Assembler to allocate the binary representation of the successive string constants, 
and/or edit functions concatenated into the fewest number of words (i.e., packed). The Assembler 
inserts “slack bits” (0’s) between successive operands as necessary. Each ASCII string constant 
or edit function begins at a bit position that is a multiple of 8; each hexadecimal string constant 
begins at a bit position that is a multiple of 4; bit string constants have no slack bits inserted. If 
the last word occupied by the concatenated string is not exactly full, the remaining bits are 
zero-filled. 
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TITLE 


TITLE 


Instruction: 


Pad 
od 


Start of program 


Source Language Format: 
ATITLEAprogram-name[,rev-number] [Apage-header] 


Description: 
Identifies the beginning of the assembly language source RprOgran This statement is required. 
The operands have the following meanings: 


program-name 
Name by which the source program can be referred to. The name must conform to the 
following rules: 
1. One through six characters (A through Z, 0 through 9, $ or _ (underscore)). 
2. First character must be one of the following: | 


a. §$ 
b. A, B....,Z 

3. The lowercase letters are considered to be equivalent to the corresponding uppercase 
letters. 


rev-number 
Optional operand identifying the revision number of the program. It must be an ASCII 
string constant of one through eight characters in length. 


page-header 
Optional comment line that will appear at the top of each page in the assembly listing 
(together with the revision number). Up to 20 characters are permitted. 
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XDEF 
XDEF 


Instruction: 


External label definition — For use with Linker only. 


Source Language Format: 
label-1 


AXDEFA int-loc-exp | 
label-2, Laat 


int-val-exp 
Description: 


Identifies labels to be made available to external procedures. These labels can then be referred to 
through XLOC and XVAL statements in the external procedures. The occurrence of a label in an 
XDEF statement does not define that label for use elsewhere within that program (the label is 
not entered into the Assembler’s symbol table). 


The operands have the following meanings: 


label-1 
Identifies a label, defined elsewhere in the source program, as an internal location label or 
internal value label (see Section 2), that can be referred to by the same name in a separately 
assembled program through an XLOC or XVAL statement. 


int-loc-exp 
label-2, 
int-val-exp 
int-loc-exp and int-val-exp are internal location or internal value expressions, respectively, 
which are evaluated by the Assembler, with the resulting value and type being associated 


| | with the label. The label can be referred to by a separately assembled program through an 
| XLOC or XVAL statement. 


Regardless of which form of the operands is used, the Assembler evaluates the label and 
generates a type and value attribute to be associated with the label. The results of the 
evaluation are passed to the Linker with the object text for use during the linking process (see 
the Program Execution and Checkout manual). The results of the evaluation are not, however, 
passed to the Loader. 

Notes: 


1. It is not necessary for all labels identified through the XDEF statement to be referred 
to by an external program. 


2. Ifalabel is not identified to an external procedure by an XDEF statement, the label can 
be defined at link time by the LDEF or VDEF command to the Linker. 


3. Ifthe label definition is to be passed to the Loader, use EDEF in lieu of XDEF. 
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XLOC 


XLOC 
Instruction: 
Define external locations to be referenced 
Source Language Format: 
AXLOCAlabela[,labelb]... 
Description: 


Identifies labels associated with locations in programs assembled separately from this program 
(i.e., external procedures), but used in this program. The same external location may be defined 
by XLOC statements more than once in an assembly language program. 


The external program must identify the labels in an XDEF or EDEF Assembler control 
statement or by an equivalent means in other programming languages. | 


The operands have the following meanings: 


label 
Identifies the external location label(s) (see Section 2) used in this program. 
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XVAL 


XVAL 


Instruction: 


Define external values to be referenced 


Source Language Format: 
AXVALAlabela[,labelb].. . 


Description: 


Identifies labels associated with values in programs assembled separately from this program 
(i.e., external procedures), but used in this program. The same external value may be defined by 
XVAL statements more than once in an assembly language program. 


The external program must identify the labels in an XDEF or EDEF Assembler control 
statement or by an equivalent means in other programming languages. 


The operands have the following meanings: 


label 
Identifies the external value label(s) (see Section 2) used in this program. 
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aa 


a 


Section 5 


Assembly Language 
Instructions 


The assembly language instruction set provides the means by which you can write your source 
programs. These assembly language instructions, which are assembled into object text, enable 
you to perform the following types of operations: 


e Arithmetic 

e Boolean 

e Branching 

e Comparison 

e Controlling 

e Input/Output 

e Loading 

e Memory Management 
e Modification 

e Move 

e Queue management 
e Shifting 

e Stack management 
e Storing 

e Swapping 


The following assembly language operations can execute only if the central processor is in the 
privileged state: 


ASD IOH RTCN 

CNFG IOLD WDTF 
HLT LEV WDTN 
IO RTCF 


The following paragraphs identify which of the assembly language instructions are included 
in each of the above operations. However, detailed information about each of the instructions is 
contained in the alphabetical list of instructions later in this section. 


In addition to identifying the assembly language instructions by operation, they are also 
listed by type (e.g., double operand). The various types can be distinguished not only by their op 
codes, but by their formats; therefore, the valid format for each type of instruction is included in 
the description of each type of instruction. However, the detailed format of each instruction is 
not shown, since the format used must conform to that described in Section 3. 


ARITHMETIC OPERATIONS 


The following assembly language instructions perform arithmetic operations (Add, Subtract, 
Multiply, Divide): 


ADD INC 
ADV MLV 
AID! MUL 
CAD NEG 
DEC SID! 
DIV SUB 


‘Instruction is executable only on the 6/40 and 6/50 models. 
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BOOLEAN OPERATIONS 


Boolean operations (Inclusive OR, Exclusive OR, AND, and NOT) are provided through the 
following assembly language instructions. 


AND -_—_—OR XOH 
ANH ORH XOR 
CPL 


BhANen OPERATIONS | 


The following instructions exist to support branching operations Granch if ... Branch uncon- 
ditionally). This subset comprises following: ° 


B BEVN BLEZ 
BAG BEZ BLZ 
BAGE BG BNE 
BAL BGE BNEZ 
BALE BGEZ BNOV 
BBF BGZ BODD 
BBT BINC BOV 
BCF BIOF BSE 
BCT BIOT BSU 
BDEC BL NOP 
BE BLE 


COMPARE OPERATIONS 


The following assembly language instructions perform the comparison operation (Compare X 
to Y): 


CMB CMR 
CMH CMV 
CMN CMZ 


CONTROL OPERATIONS 


Control instructions affect the flow of an assembly language program. They provide a means 
of entering trap handlers, starting and stopping hardware clocks, passing control to system 
service routines or external procedures, and jumping. This subset comprises the following: 


BRK LEV RTT 

CNFG? LNJ WDTF 

ENT MCL . WDTN- 

HLT RTCF 

JMP RTCN 
INPUT/OUTPUT OPERATIONS 


The following assembly language instructions are provided to support the input/output 
operations: 


IO IOH IOLD 
LOAD OPERATIONS | 
Load operations are provided through the following instructions: 
LAB LBT LDR 
LB LDB LDV 
LBC LDH LLH 
LBS LDI LRDB? 
RSTR 


2Instruction is executable only on the 6/40 and 6/50 models. 
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MEMORY MANAGEMENT OPERATIONS 


The following assembly language instructions are provided to support the memory manage- 
ment operations:? 


ASD VLD 


MODIFY OPERATIONS 


Modification (Clear Memory, Increment or Decrement the Contents of a Memory Location) 
operations are provided by the following assembly language instructions: 


CL CLH MTM 


MOVE OPERATION 
The following instruction performs a move operation: 
MMM? 


QUEUE OPERATIONS 
Programmer’s reference information for queue instructions are in Appendix J. 


The following assembly language instructions are provided to support queue operations:® 


DQA QOH 
DQH QOT 
SHIFT OPERATIONS 
Shift operations are achieved through the following assembly language instructions: 
DAL DOL SCL 
DAR DOR SCR 
DCL SAL SOL 
DCR SAR SOR 


STACK OPERATIONS 
Programmer’s reference information for stack instructions are in Appendix K. 
The following assembly language instructions are provided to support stack operations:® 


ACQ RLQ 
LDT STT 


STORE OPERATIONS 


The following assembly language instructions are available to store the contents of specific 
registers in main memory or other registers: 


SAVE STB STR 
SDI STH STS 
SRDB STM 

SRM 


SWAP OPERATIONS 
Swapping (i.e., exchanging) is supported through the following: 
SWB SWR 


3Memory management operations require a Memory Management Unit which is available only on the 6/40 and 6/50 
models. 

4Instruction is executable only on the 6/40 and 6/50 models. 

5The hardware required for queue operations is available only with the 6/40 models. 

6The hardware required for stack operations is available only with the 6/40 models. 
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ASSEMBLY LANGUAGE INSTRUCTION TYPES | 

In addition to identifying assembly language instructions by the operations they perform, 
they can be classified by type: | 

e Branch-on-indicator (BI) 

e Branch-on-register (BR) 

e Double operand (DO) 

e Generic (GE) | 

e Input/output (IO) 

e Shift (SHS and SHL) 

e Short-value-immediate (SI) 

e Single operand (SO) 


BRANCH-ON-INDICATOR (BI) INSTRUCTIONS 
Branch-on-indicator (BI) instructions have the following source language format: 
[label]AopcodeAaddress-expression 
The opcode identifies the I-register bit(s) to be tested for a specific condition. 


The address-expression identifies the address of the next instruction to be executed if the 
condition exists. It must specify one of the following addressing forms (see “Addressing 
Techniques” in this section): 


e Direct Immediate memory address 
e Direct P-relative 
e Short displacement 


The BI instructions are included in the alphabetical list of assembly language instructions 
later in this section: 


BRANCH-ON-REGISTER (BR) INSTRUCTIONS 
Branch-on-register (BR) instructions have the following source language format: 


[label]AopcodeA | B-register ,address-expression 
binary-integer-constant } 


The opcode identifies the R-register condition that is to be tested for the existence of a specific 
condition. 


The first operand identifies the R-register to be tested. Ifa binary integer constant is specified, 
the assembler assumes that the integer is an R-register identifier. 


The second operand specifies one of the following addressing forms (see “Addressing 
Techniques” in this section): 


e Direct immediate memory address 
e Direct P-relative 
e Short displacement 


See the alphabetical list of instructions later in this section for detailed descriptions of the BR 
mstructions. | 


DOUBLE OPERAND (DO) INSTRUCTIONS 
Double operand (DO) instructions have the following source language format: 
R-register 
B-register 
[label]AopcodeA < M-register ,address-expression |,mask | _ 
S-register 
binary-integer-constant 
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The opcode identifies the operation to be performed and the type of register that is required in 
the first operand. | 


The first operand identifies the register that contains one of the data elements to be used in the 
operation, as well as the register that is to contain the result. If the Scientific Instruction 
Processor is present, the S-registers are hardware registers; otherwise, they may be provided as 
software-simulated scientific registers maintained by the Floating-Point Simulator. In the 6/40 
and 6/50 models the M-registers are hardware registers. In the 6/30 models only M1 is a 
hardware register. In the 6/30 models, M2 through M7 may be provided as software-simulated 
mode registers. The Floating-Point Simulator maintains the M4 and M5 registers and the 
Commercial Processor simulator maintains the M3 register. There is no Honeywell-supplied 
software to maintain the simulated M2, M6, and M7 registers. 


The second operand specifies an address expression that gives the location of the other data 
element to be used in the operation. If an address expression is not specified, the second operand 
must be a complex label equated to an address expression. (See “Labels” in Section 2 for a 
description of complex labels, and “Addressing Techniques” in this section for a description of 
address expressions.) 


The third operand is valid only for the Store Register Masked (SRM) instruction. 


The alphabetical list of assembly language instructions later in this section provides detailed 
descriptions of each of the DO instructions. 


GENERIC (GE) INSTRUCTIONS 


Generic (GE) instructions, as defined in assembly language or by the user (with a DEFGEN 
statement) have the following format: 


[label ]Aopcode 


The alphabetical list of instructions later in this section describes the GE instructions. 
INPUT/OUTPUT (10) INSTRUCTIONS 


Input/output (IO) instructions have the following source language format: 
[label ]AopcodeAaddress-expression,address-expression[,address-expression ] 

The opcode identifies the instruction as one of the following types: 

e Data and command I/O 

e Address and range output 


The address expression in the first operand identifies the location from which a data word is 
transferred to the I/O bus, or the location to which a data word is transferred from the I/O bus. 


The second operand address expression identifies the channel number and function code, or 
the location where this information can be found. 


The third operand address expression is valid only for the input/output load (IOLD) 
instruction. It identifies the location of the word that contains the range. When this instruction 
is specified, the address expression in the first operand identifies the location of the first byte ofa 
buffer of data to be transferred to or from the device addressed by the channel number specified 
by the second operand. 


Address expressions are described under “Addressing Techniques” in this section. The IO 
instructions are described in the alphabetical list later in this section. 


SHIFT (SHS AND SHL) INSTRUCTIONS 


Shift (SHS and SHL) instructions have the following source language format: 


[label JAopcodeA eee alee ,int-val-expression 


The opcode identifies the format, type and direction of the shift. The formats can be: 
e SHS — Shift short 
e SHL — Shift long 
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The valid types are: 
e Arithmetic 
e Open 
a Closed 
The direction of the shift can be: 
e Right 
e Left 


The first operand identifies the register (or register pair for long-precision shifts) containing 
the data to be shifted. For short-precision shifts, any R-register can be specified; for 
long-precision shifts, the R-register specified must be $R3, $R5, or $R7, with the preceding 
even-numbered register ($R2, $R4, or $R6, respectively) being implied. Use of an integer 
constant implies that the R-register with that number is specified. 


The internal value expression (see Section 1) in the second operand specifies the number of 
bits to be shifted. For short-precision shifts, the count must be within the range 1 through 15; if 0 
is specified, the system uses the value found in bits 12 through 15 of $R1. For long-precision 
shifts, the count must be within the range 1 through 31; if 0 is specified, the value in bits 11 
through 15 of $R1 is used. 


Detailed descriptions of the SHS and SHL instructions are included in the alphabetical list of 
instructions later in this section. | 


SHORT-VALUE-IMMEDIATE (SI) INSTRUCTIONS 


Short-value-immediate (SI) instructions have the following source language format: 


Commercial-Processor- edit-function } 
Assembler-function 
R-register _ binary-integer-constant 
[label JAopeodeA sg A=] string-constant 
internal-value-label 
int-val-expression 


The opcode identifies the operation to be performed. 


The first operand specifies an R-register that contains one of the data elements to be operated 
upon and receives the result of the operation. If a binary integer constant is used, the 
corresponding R-register is assumed (i.e., X‘5’ implies R-register $R5). 

The second operand is a 1-byte (8-bit) value. If it is a string constant (see Section 2), it is 
treated as a half-word string; if the length of the string is greater than 8 bits, low order (i.e., the 
rightmost) bits are truncated; if less than 8 bits, 0’s are appended to the low order bit positions. If 
the second operand is not a string constant, the value is considered to be numeric within the 
range —128 to +127. 


Binary integer constants, string constants, internal value labels, internal value expressions, 
and fixed point constants are described in Section 2. The SI instructions are described in detail in 
the alphabetical list later in this section. 


SINGLE OPERAND (SO) INSTRUCTIONS 


Single operand (SO) instructions have the following source language format: 


Commercial-Processor- edit-function' 
Assembler-function 
binary-integer-constant 
string-constant 

internal-value-label 
external-value-label 
int-val-expression 
single-precision-fixed-point-constant 


[label]AopcodeAaddr-expression ]}, 
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The opcode identifies the operation to be performed. 


The first operand address expression (see “Addressing Techniques” in this section) identifies 
the location of the data element to be operated upon. 


The second operand is valid only for the Save (SAVE), Restore (RSTR) and bit handling 
instructions. It specifies the value of a one-word mask that indicates which registers are to be 
saved and restored or which bits are to be manipulated. Binary integer constants, string 
constants, internal value labels, external value labels, internal value expressions, fixed point 
constants are described in Section 2. 


The SO instructions are described in the alphabetical list of assembly language instructions 
later in this section. 


ADDRESSING TECHNIQUES 


Many of the assembly language instructions require the use of address expressions in their 
operand fields. Address expressions can take any of the following forms: 


e Register addressing 

e Immediate memory addressing 
e Immediate operand addressing 
e P-relative addressing 

e B-relative addressing 

e Short displacement addressing 
e Special addressing 

e Interrupt vector addressing 


Any of these addressing forms can be used to specify the location of data to be used in an 
operation. Furthermore, the data can be referenced directly, ame via indexing, or by 
utilizing the push/pop feature. 


REGISTER ADDRESSING 


Register addressing is specified when a value or address is contained in a register. This form of 

address expression is specified as follows: 
=$Rn =$Bn =$Sn | 

=$Rn, =$Bn, and =$Sn are mutually exclusive; i.e., some instructions permit the use of 
=$Rn and others allow =$Bn (the descriptions of the various instructions identify which is valid 
for that instruction). The =$Rn form is generally used in those instructions that require some 
data to be contained in the register. The =$Bn form is valid for those instructions that expect to 
find an address in the register. The =$Sn form addresses the scientific accumulator registers. 


The following examples illustrate register addressing. In the examples, assume that $B5 
contains the address 3FFF, that $B3 contains the address 12A4, that $R5 contains the value 
2012, and that $R7 contains the value O0ED. 


Example 1: 
ADD X‘7’,=$R5 
In this example, the contents of $R5 are added to the contents of $R7, and the result (20FF) is 
stored in $R7. Since this instruction requires that the first operand specify an R-register, the 


Assembler assumes that the integer constant refers to $R7 and generates code to execute the 
instruction accordingly. 


Example 2: 
LDB $B5,=$B3 
In this example, the address stored in $B3 is loaded into $B5d. 
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IMMEDIATE MEMORY ADDRESSING (IMA) 


Immediate memory addressing is specified when an address is contained in a main memory 
location. This form of addressing allows you to reference a location directly, indirectly, and 
through indexing (direct or indirect). Depending on how you wish to reference the memory 
location, you can specify immediate memory addressing as follows: 


+ 


( location-expression 
< 
-{ temporary-label 


| Direct IMA 


+ | Indirect IMA 


location-expression 
ae 
: temporary-label ) 


location-expression 1 
< + .$R 2 Indexed Direct IMA 


: temporary-label 3 


+ 


location-expression 
ae -< 
| : temporary-label 


1 
| $R 2 | Indexed Indirect IMA 
3 


When a source instruction indicating immediate memory addressing is assembled, the actual 


address of the operand is assembled into the operand field. Therefore, any internal, external, or 
common location expression is a valid operand. In contrast, P-relative addressing (defined later 
in this section) creates object code in which the displacement from the current displacement 
word to the operand is assembled into the operand field. 


DIRECT IMMEDIATE MEMORY ADDRESSING 
Direct immediate memory addressing makes it possible for you to specify explicitly the 
location of the data or address to be used in an operation. 


The following example illustrates the use of this form of immediate memory addressing. In 
the example, assume that INTLBI is an internal location label at location 20F4 and that location 
contains the address OFOB, and that $B3 contains the address 111A.. 


Example: 
LDB $B3,<INTLBI 


In this example, the contents (OFOB) of location 20F4 (specified by the INTLBD are loaded 
into $B3, replacing its current contents. 


Figure 5-1 illustrates how the instruction in the example is stored in memory and how the 
data is found. 


ASSEMBLED INSTRUCTION 
(LDB $B3,<INTLB1) 


ee te 


LOCATION 20F4 


MEMORY abdacumaca ADDRESS) 


Figure 5-1. Direct Immediate Memory Addressing 
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INDIRECT IMMEDIATE MEMORY ADDRESSING 


This form of immediate memory addressing is available when you want to refer to a location 
whose address is stored in another location. 

The following example illustrates the use of this form of immediate memory addressing. 
Assume that $C is a temporary label, whose next definition is at location 30A2 and that location 
contains the address 100C. Further, assume that location 100C contains the value OF2C, and 
that $R6 contains the value 10D3. 


Example: 
ADD $R6,* <+$C 
In this example, the system goes to the location specified at location 30A2 (identified by + $C, 
the + indicating that a forward reference is involved), which is 100C. It then adds the value 
found there (i.e., OF2C) to the contents of $R6, and stores the result (1FFF) in $R6. 
Figure 5-2 illustrates how the instruction appears in memory and how the data used in the 
instruction is found. 


LOCATION 100C 
(EFFECTIVE ADDRESS) 


ASSEMBLED INSTRUCTION 
(ADD $R6,*<+$C) 


A a 


LOCATION 30A2 


Figure 5-2. Indirect Immediate Memory Addressing 


INDEXED DIRECT IMMEDIATE MEMORY ADDRESSING 


Indexed direct immediate memory addressing is available when you want to refer to data or 
an address that has a known displacement beyond a specific location. 


The following example illustrates the use of this form of immediate memory addressing. 
Assume that TABLE1 is an internal location label at location 2000, and that word 3 in the table 
is the address of an error routine. Also, assume that $R3 contains the value 0003. 

Example: 

LDB $B1,<TABLE1,$R3 
In this example, for a SAF configuration, the system adds the contents of the index register ($R3) 
to the address of TABLE] (i.e., 2000). Then the contents of that location (i.e., the address of the 
error routine) are loaded into $B1. 

For a LAF configuration, the system effectively multiplies the contents of the index register 
by 2 because the instruction is a base register instruction, and then adds this product to the 
address of TABLE1. (After this instruction is performed, the contents of $R3 remain un- 
changed.) 
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Figure 5-3 illustrates how the instruction appears in memory and how it locates the effective 
address. | oo - 


ASSEMBLED INSTRUCTION 
-(LDB $B1,<TABLE1.$R3) 


| a a 
[ee] ee [ 
LOCATION 2003 (2006 IN LAF) 


LOCATION 2000 (EFFECTIVE ADDRESS) 


; Valet 
weworv = t TTT 
—_IN_ ed _ | 
R3 m 
0003 J- — — — -» +3 POINTERS 


Figure 5-3. Indexed Direct Immediate Memory Addressing 


INDEXED INDIRECT IMMEDIATE MEMORY ADDRESSING 


This form of immediate memory addressing combines the feature of indirect immediate 
memory addressing with indexing to generate the location of the data or address to be used in an 
operation. 3 

The following example illustrates the use of this form of immediate memory addressing. In 
the example, assume that TABL1A is an internal location label at location 20AA and that that 
location contains the address 30FF. Also assume that $R1 contains the value OF00, that $R2 
contains the value 401A, and that location 3FFF contains the value 3D91. 


Example: 
ADD $R2,* <TABL1A.$R1 | 
In this example, the contents of $R1 (i.e., OFO0) are added to the contents of location 20AA (i.e., 
_ 80FF) to obtain the effective address of the data to be used in the operation. Then, the data 


found at location 3FFF (OF00 + 30FF) is added to the contents of $R2 as follows: 3D91 + 401A 
= 7TDAB. The result is then stored in $R2. 


Figure 5-4 illustrates how the instruction appears in memory, and how the system locates the 
data to be used in the operation. 


IMMEDIATE OPERAND ADDRESSING 


Immediate operand addressing makes it possible to specify a literal value or address as the 
address expression. Depending on the type of instruction, this form of addressing must be 
specified in one of the following forms: 


= location-expression (LDB, STB, SWB, CMB, CMN) 
_ {string-constant (SAD, SCM, SCZD, SDV, SLD, 
floating-point-constant 


SML, SNGD, SSB, SST, SSW) 


internal-value-expression | 
external-value-label — | (All other CP instructions) 
fixed-point-constant | | 
external-value-expression 
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ASSEMBLED INSTRUCTION 
(ADD $R2,*<TABL1A.$R1) 


a th 


LOCATION 20AA 


LOCATION 3FFF 
LOCATION 30FF (EFFECTIVE ADDRESS) 


emma, 


2 + OFOO0 WORDS 


MEMORY 


Figure 5-4. Indexed Indirect Immediate Memory Addressing 


The string-constant form must specify a value that provides the following information for the 
scientific instructions: 


Bit: 0 6 7 8 3] 


c Characteristic (excess 64 power-of-16 exponent) of the mantissa. 

s Sign (0 = positive; 1 = negative) on the mantissa. 

m Magnitude of the mantissa. 

The following examples illustrate the use of the immediate operand addressing form of 
addressing. Assume that $81 is the scientific accumulator register and that it contains the value 
84130000 (indicating a floating-point number with a value of 19), that $R5 contains the value 
300A, and that INTVAL is the label of an internal value expression that is equated to 1FF3. 


Example 1: 

SAD $S1,=Z‘8280000A’ 
In this example, the floating-point value specified by the hexadecimal string constant (i.e., 
8.000010), is added to the floating-point value stored in $S1 (i.e., 19), and the result is stored 
in $S1. 
The following code: 

SAD $81,= 8.000010 


which uses a floating-point constant value, will produce the same object code as example 1, 
above. 


Figure 5-5 illustrates how the above example is stored in memory and how it determines the | 
effective address. 


ASSEMBLED INSTRUCTION 
(SAD $S1,=2Z’8280000A’) 


ee _ eee” 


EFFECTIVE ADDRESS 


Figure 5-5. Immediate Operand Addressing-Scientific Instruction 
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Example 2: 
ADD §R5,=INTVAL 


In this example, the value equated to the internal véiue jabel INTVAL (i.e. , 1FF3) i is added to the value 
contained in $R5 (i.e., 300A), and the result (4FFD) is stored in $R5. 


Figure 5-6 illustrates how the above ADD instruction is stored in memory and how it finds the 
effective address. 


ASSEMBLED INSTRUCTION 
(ADD $R5,=INTVAL) 


ee 
soon {Joesfv] J 
| . EFFECTIVE ADDRESS 
Figure 5-6. Immediate Operand Addressing 
P-RELATIVE ADDRESSING 


P-relative addressing is available for those situations in which you want to reference data or 
an address by indicating its (Assembler-calculated) displacement from the current location (i.e., 
the location of the currently executing instruction). This form of addressing allows you to 
reference a location directly or indirectly. Depending on which way you want to reference a 
location, you can specify P-relative addressing as follows: 

location-expression 
+ Direct P-Relative Addressing 
temporary-label 
location-expression 


‘s +). _ Indirect P-Relative Addressing 
temporary-label 


DIRECT P-RELATIVE ADDRESSING | 
This form of addressing is available when you want to specify a location relative to the 
contents of the P-register (i.e., the address of the currently executing instruction) directly. 


The following example illustrates this form of P-relative addressing. In the example, assume 
that $R5 contains the value 3F10, and that INTLOC is an internal location label at location 
1110, which contains the value 1E10. 


Example: 
SUB $R5,INTLOC 


In this example, the contents of the location identified by INTLOC (1E10) are subtracted from 
the contents of $R5, and the result (2100) is stored in $R5. 


Figure 5-7 illustrates the above instruction in memory, and shows how it finds the effective 
address. 


LOCATION 1110 © ASSEMBLED INSTRUCTION 
(EFFECTIVE ADDR eppnES (SUB B SRE, NSLOG) 


~ LOCATION 2000 
1110-2000=-EFO0 WORDS ccoaiianna, F110) 


Figure 5-7. Direct P-Relative Addressing 
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INDIRECT P-RELATIVE ADDRESSING 


Indirect P-relative addressing is similar to indirect immediate memory addressing. 


The following example illustrates indirect P-relative addressing. In the example assume that 
$E precedes the current instruction, and that location that it identifies contains the address 
3000; furthermore, assume that location 3000 contains the value 20AA, and that $R1 contains 
the value 4F44. 

Example: 
ADD $R1,*—$E 


This instruction adds the contents of the location pointed to by location 3000 (i.e., 20AA) to the 
value contained in $R1, and stores the result (6FEE) in $R1. 


Figure 5-8 shows how the instruction described above is stored in memory and how it locates 
the data to be used in the operation. 


, ASSEMBLED INSTRUCTION 
LABEL $E (ADD $R1,*-SE) 


ae er th 


MEMORY LOCATION 3000 
wee (EFFECTIVE ADDRESS) 


2000-2051=-51 (1.E., FFAF) 


Figure 5-8. Indirect P-Relative Addressing 


B-RELATIVE ADDRESSING 


In B-relative addressing, a base register (i.e., $B1, $B2, ... $B7) is used to reference a location 
that contains data or an address. This form or addressing can be used to reference a location 
directly, indirectly, through indexing, as a displacement, or through the push/pop feature. 


The push feature causes the hardware to automatically decrement the contents of the specified 
base or index register before executing the instruction. The pop feature causes the hardware to 
automatically increment its contents after execution. 


B-relative addressing can take any of the formats given below. The first four forms are similar 
to their immediate memory addressing counterparts, except that the location of the data or 
address to be used in the operation is contained in a base register rather than being expressed as 
a location expression or label. The next two are similar to the P-relative forms of addressing. The 
$B6.$LCOMW forms are provided to facilitate the writing ofreentrant programs. Guidelines for 
writing reentrant programs are given in the Program Preparation manual. 


$Bn — Direct B-relative addressing 
*$Bn — Indirect B-relative addressing 
1 
$Bn.$R 42 — Indexed direct B-relative addressing 
3 
1 
*SBn.$R { 2 — Indexed indirect B-relative addressing 
3 
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$Bn. 


-int-val-expression | | 
— Direct B-relative plus displacement addressing 


( external-val-label } _ 
int-val-expression | 
*$Bn.4 | _ — Indirect B-relative plus displacement addressing 


external-val-label 


$B6.$LCOMW + int-val-expression — _ Direct B6 relative plus local common block plus 
displacement addressing 


*$B6.$LCOMW-+ int-val-expression — Indirect B6 relative plus local common block 
ss plus displacement addressing 


—$Bn — B-relative addressing with automatic decrement before 
execution (Push) 7 


4+$Bn — B-relative addressing with automatic increment after 
execution (Pop) 


>| 1 — Indexed direct B-relative addressing 
$B 42; ,—$R | with automatic decrement of index 
3 f register before execution (Push) 

1 1 — Indexed direct B-relative addressing 
$B 2 +$R 1 2 with automatic increment of index 

3 3 register after execution (Pop) 


DIRECT B-RELATIVE ADDRESSING 


This form of addressing is available when you want to use data or an address whose location is 
contained in a base register. 


The following example illustrates direct B-relative addressing. In the example, assume that 
$B7 contains the address 20F2, and that $B2 contains the address 4FFF. 


Example: 
LDB $B2,$B7 


In this example, the contents of the location whose address is contained in $B7 are loaded into 
and replace the contents of $B2. 


Figure 5-9 shows how the instruction in the example is stored in memory and how the effective 
address is found. | 


ASSEMBLED INSTRUCTION 
(LDB $B2,$B7) 


Vieni 


MEMORY 
oO LOCATION 20F2 


(EFFECTIVE ADDRESS) 


Figure 5-9. Direct B-Relative Addressing 
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INDIRECT B-RELATIVE ADDRESSING 
Like indirect immediate memory addressing, this form of addressing is used when you want to 
use data or an address contained at a location whose address is pointed to by a base register. 


The following example illustrates indirect B-relative addressing. In the example, $B3 
contains the address 100F, address 100F contains address 302A, and address 302A contains the 
address 3FFF; furthermore, $B1 contains the address 1110. 


Example: 
STB $B1,*$B3 
In this example, the address 1110 is stored at location 302A, replacing the address that was 
contained there (i.e., 3FFF). 
Figure 5-10 illustrates how the sample instruction is stored in memory and how it derives the 
effective address. 


ASSEMBLED INSTRUCTION 
(STB $B1,*$B3) LOCATION 100F 


Vextinaen cate aaant 
\ fers] 
B3 


MEMORY 


LOCATION 302A 
(EFFECTIVE ADDRESS) 


Figure 5-10. Indirect B-Relative Addressing 


INDEXED DIRECT B-RELATIVE ADDRESSING 


This form of addressing, like indexed direct immediate memory addressing, uses an index 
register to compute the effective address of the data or address to be used in the operation. The 
contents of the index register are effectively multiplied by a factor (the factor is determined by 
the instruction) and added to the contents of the base register to derive the location of the data or 
address to be included in the operation. 


In the following example, which illustrates indexed direct B-relative addressing, $R3 
contains the value 1110, $R1 contains the value 0002, $B5 contains the address 3FFD, and 
memory location 3FFF contains the value 9999. 


Example: 
ADD $R3,$B5.$R1 


In this example, the system adds the contents of $R1 (effectively multiplied by one) to the 
contents of $B5 to compute the address of the data to be used in the operation. The result is 
3FFF (i.e., 3FFD + 2). The contents of location 3FFF are added to the contents of $R3, and the 
result (AAAQ) is stored in $R3. 
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Figure 5-11 illustrates how the above example appears in memory. 


ASSEMBLED INSTRUCTION 
ADD $R3, $B5.$R1__ 


| . LOCATION 3FFF 
LOCATION 3FFD (EFFECTIVE ADDRESS) 


Vf fe} Tf 


+ 2 WORDS 


MEMORY 
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Figure 5-11. Indexed Direct B-Relative Addressing 


INDEXED INDIRECT B-RELATIVE ADDRESSING 


This form of B-relative addressing is similar to indexed indirect immediate memory 
addressing. The contents of the index register are effectively multiplied by a factor (the factor is 
determined by the instruction) and added to the contents of the location pointed to by the base 
register to obtain the effective address of the data to be used in the operation. 

The following example illustrates this form of addressing. In the example, assume that $B5 
contains the address 2022 and that that address contains the address 1000; also, assume that 
¢$R2 contains the value 40FF, that $R1 contains the value 001A, and that location 101A contains 


the value 1001. 
Example: 
ADD $R2,*$B5.$R1 | 
In this example, the contents of $R1 (001A) are added to the contents of the location pointed to 
by $B5 (1000). The contents of the resulting location (101A) are added to the contents of $R2, 
and the result (5100) is stored in $R2. 


Figure 5-12 illustrates how the sample instruction is stored in memory and how it derives the 
effective address. 


DIRECT B-RELATIVE PLUS DISPLACEMENT ADDRESSING 


This form of addressing causes the system to compute the effective address by adding a specific 
value to the contents of a base register. | 


The following example illustrates this form of addressing. In the example, assume that. 


XVALZ2A is an external value label equated to the value 000A, that $B5 contains the address 
2000, that memory location 200A contains the value 20ED and that $R6 contains the value 
6DFE. 
Example: 
SUB $R6,$B5.XVAL2A 

This instruction computes the effective address of the data to be used by adding 000A to the 

contents of $B5 (2000). It then subtracts the contents (20ED) of the effective address (200A) 

from the contents of $R6, and stores the result (4D11) in $R6. 

Figure 5-13 shows how the above example is stored in memory and how it derives the effective 
address of the data. 
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ASSEMBLED INSTRUCTION 
(ADD $R2,*$B5.$R1) 


LOCATION 2022 


MEMORY | LOCATION 101A 
| LOCATION 1000 (EFFECTIVE ADDRESS) 
eae ee eT 
. gus a, 


+ 1A WORDS 
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Figure 5-12. Indexed Indirect B-Relative Addressing 
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ASSEMBLED INSTRUCTION 
(SUB $R6,$B5.XVAL2A) 


a th 


MEMORY 


LOCATION 200A 
LOCATION 2000 (EFFECTIVE ADDRESS) 


a th Fe th 


Figure 5-13. Direct B-Relative Plus Displacement Addressing 
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INDIRECT B-RELATIVE PLUS DISPLACEMENT ADDRESSING 


This form of effectively addressing adds a displacement value to the contents of the specified 
base register. Then, the effective address is the contents of the location whose address is derived 
through this preceding operation. - ; 

In the following example of this form of addressing, EXP10 is an teens value expression 
equated to 0010, $B4 contains the address 30FF, location 310F contains the address 10FE, 
location 10FE contains the value 400D, and $k7 contains the value 1013. 


Example: 
ADD $R7,*$B4.EXP10 
_ In this example, the displacement value 0010 is added to the contents of $B4 (i.e., 0010 + 
30FF), producing the address 310F. Then, applying the indirection operator, the contents of 
the location 310F (i.e., 1|OFE) are used as a memory address. The value found at location 10FE 
(i.e., 400D) is added to the contents of $R7. The result (5020) is stored in $R7. 
Figure 5-14 illustrates how this form of addressing generates an effective address when stored 
in memory. 


ASSEMBLED INSTRUCTION 
(ADD $R7, pilasauae, EXP10) 


LOCATION 10FE 
(EFFECTIVE ADDRESS) 
(at tlie cme 


MEMORY 


Figure 5-14. Indirect B-Relative Plus Displacement Addressing 


DIRECT B6-RELATIVE PLUS LOCAL COMMON BLOCK PLUS DISPLACEMENT ADDRESSING 


In this form of addressing, the effective address is computed by adding a specified value to the 

contents of base register $B6. This addressing form assumes that $B6 contains the address of the 
combined $LCOMW local common blocks. For information on the loading of $B6, see the 
Program Execution and Checkout manual. The value that is added to the contents of $B6 is 
assumed to be an offset value (before adjustment by the Linker) into the local common block, 


$LCOMW. 


Example: 
TEN EQU 10 
$LCOMW LCOMM — 300 
ORG $LCOMW-+ 10 
DC — 100 
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In this example, suppose that the constant 100 which is contained in the eleventh word of the 
local common block, $LCOMW,, is to be loaded into data register $R1. If at execution time, $B6 
contains the address of the combined $LCOMW local common blocks, then either of the 
following instructions will accomplish the desired result. 


LDR $R1,$B6.$LCOMW+TEN 


LDR $R1,$B6.SLCOMW+10 
Figure 5-15 illustrates how this form of addressing generates an effective address when stored 
in memory. 


ASSEMBLED INSTRUCTION 
NOTE: THIS EXAMPLE ASSUMES THAT THE 
(LDR $R1, $B6. $LCOMW + 10) COMPILE UNIT CONTAINING THIS 


EXAMPLE IS LINKED AS THE FIRST 


et 
COMPILE UNIT IN A GIVEN OVERLAY; 
9846 000A THE LINKER ACTUALLY INCREMENTS 
THE DISPLACEMENT (000A IN THIS 


EXAMPLE) BY THE SUM OF THE SIZES 

ON THE $LCOMW LOCAL COMMON 

BLOCKS IN THOSE COMPILE UNITS 
POINTER TO THAT ARE LINKED PRIOR TO THE 
WORD O OF CONCERNED COMPILE UNIT WITHIN 
$LCOMW ANY GIVEN OVERLAY. 


WORD O (i.e., FIRST WORD) 
OF LOCAL COMMON BLOCK 
$LCOMW EFFECTIVE ADDRESS 


NEE EELEL EL | [om] / 


> +10WORDS 
Figure 5-15. Direct B6-Relative Plus Local Common Block Plus Displacement Addressing 


INDIRECT B6 - 
RELATIVE PLUS LOCAL COMMON BLOCK PLUS DISPLACEMENT ADDRESSING 


In this form of addressing, the effective address is specified by the contents of the location 
computed by effectively adding a value to the contents of base register $B6. This addressing form 
assumes that $B6 contains the address of the combined $LCOMW local common blocks. For 
information on the loading of $B6, see the Program Execution and Checkout manual. The value 
that is added to the contents of $B6 is assumed to be an offset value (before adjustment by the 
Linker) into the local common block, $LCOMW. 


Example: 
$LCOMW LCOMM — 300 
ORG $LCOMW 
DC <CONST 
ORG $LCOMW+ 20 
CONST DC 100 


In this example, assume that the constant 100 which is contained in the 21st word of the local 
common block, $LCOMW, is to be loaded into data register $R1, and that the address of the 
constant is known to be in word zero of the local common block. If at execution time, $B6 
contains the address of the local common block, then the following instruction will accomplish 
the desired result. 


LDR $R1,*$B6.SLCOMW 


Figure 5-16 illustrates how this form of addressing generates an effective address when stored 
in memory. 
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ASSEMBLED INSTRUCTION 
(LDR $R1, *$B6. $LCOMW) 
| SE 


984e | 0000 | 


B6 


POINTER TO 
WORD O OF 
$LCOMW 


NOTE: THIS EXAMPLE ASSUMES THAT THE 
COMPILE UNIT CONTAINING THIS 
EXAMPLE IS LINKED AS THE FIRST 
COMPILE UNIT IN A GIVEN OVERLAY; 
THE LINKER ACTUALLY INCREMENTS 
THE DISPLACEMENT (000A IN THIS 
EXAMPLE) BY THE SUM OF THE SIZES 
ON THE $LCOMW.LOCAL COMMON 
BLOCKS IN THOSE COMPILE UNITS 
THAT ARE LINKED PRIOR TO THE 
CONCERNED COMPILE UNIT WITHIN 
ANY GIVEN OVERLAY. 


MEMORY 


WORD O (FIRST WORD) EFFECTIVE 
OF $LCOMW ADDRESS 
POINTER TO CONST, 

WHICH IS $LCOMW + 20 ‘ie 0064 
(i.e., << $ + 20) 


O WORDS - “INDIRECTION” 


— -- =e 
Figure 5-16. Indirect B6-Relative Plus Local Common Block Plus Displacement Addressing 


B-RELATIVE PUSH ADDRESSING 


This form of B-relative addressing causes the contents of the specified base register to be 
decremented before the effective address is formed. The new address in the register is the 
effective address of the location or data to be used in the operation. The B register is decremented 
by: 

e One for all instructions accessing one-bit, one-byte, or one-word operands. 

e Two for all instructions accessing double-word operands. | 

e Four for all instructions accessing quadruple-word operands. 

e One for SAF configurations or two for LAF configurations for the LDB, STB, SWB, CMB, 

and CMN instructions. 

Note: 

LAB is an instruction accessing a one-word operand. 

In the following example, $R5 contains the value 30FF,$B5 contains the address 4011, and 
memory location 4010 contains the value 0001. 

Example: 
ADD $R5,—$B5 


In this example, the contents of location derived by subtracting one from the address con- 

tained in $B5 are added to the contents of $R5, and the result (3100) is stored in $R5. The next 

time $B5 is used, it will contain the address 4010. 

Figure 5-17 illustrates how the sample instruction described above is stored in memory and 
how it derives the effective address of the data to be used in the operation. 


ASSEMBLED INSTRUCTIONS 
(ADD $R5,-$B5) 


Fn ti 


LOCATION 4010 
(EFFECTIVE ADDRESS) 


MEMORY 


BEFORE: 


AFTER: 


Figure 5-17. B-Relative Push Addressing 
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B-RELATIVE POP ADDRESSING 


This form of B-relative addressing causes the contents of the specified base register to be 
See, incremented after the effective address is formed. The old address that was in the register is the 
( effective address of the location or data to be used in the operation. The B register is incremented 

7 by: 

e One for all instructions accessing one-bit, one-byte, or one-word operands. 

e Two for all instructions accessing double-word operands. 

e Four for all instructions accessing quadruple-word operands. 

e One for SAF configurations or two for LAF configurations for the LDB, STB, SWB, CMB, 

and CMN instructions. | 

Note: 

LAB is an instruction accessing a one-word operand. 


In the following example, $R3 contains the value 222A. $B2 contains the address A000 and 
location A000 contains the value 0005. 


Example: 
ADD $R3.+$B2 
In this example, the contents of location A000 are added to the contents of $R3, and the 
result (222F) is stored in $R3. 


The address stored in $B2 is then incremented by one. The next time $B2 is used in an 
instruction, it will contain the address A001. 


Figure 5-18 shows how the instruction above is stored in memory and how it derives an 
effective address. 


ASSEMBLED INSTRUCTION 
(ADD $R3,+$B2) LOCATION A000 
pos (EFFECTIVE ADDRESS) 


MEMORY 


BEFORE: 


AFTER: 


Figure 5-18. B-Relative Pop Addressing 


INDEXED B-RELATIVE PUSH ADDRESSING 


This form of B-relative addressing decrements the contents of the specified index register by 1, 
then computes the effective address of the data or address to be used in the operation as 
described under “Indexed Direct B-Relative Addressing,” above. 


In the following example, $R1 contains the value 0003, $R2 contains the value 20F0, $B3 
contains the address 20A0, and memory location 20A2 contains the value DFOF. 


Example: 
ADD $R2,$B3.—$R1 
In this example, the effective address of the data to be used in the operation is derived by 
subtracting 1 from the contents of the index register, then effectively adding the revised 
contents to the address contained in $B3. Then, the contents ofthe effective address are added 
to the contents of $R2 (i.e., 20FO + DFOF), and the result (FFFF) is stored in $R2. The next 
time the index register $R1 is used, it will contain the value 0002. 
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When indexed B-relative push addressing is used, only base registers $B1, $B2, or $B3 can be 
specified in the address expression. Figure 5-19 illustrates how the sample instruction described 
above is stored in memory and how it derives the effective address of the data to be used i in the 
operation. 


ASSEMBLED INSTRUCTION LOCATION 20A2 
(ADD $R2,$B3. BS SN) | LOCATION See oeceay Ye ADDRESS 


MEMORY 


Figure 5-19. Indexed B-Relative Push Addressing 


INDEXED B-RELATIVE POP ADDRESSING 


This form of B-relative addressing computes the effective address of the location or data to be 
used in the operation as described under “Indexed Direct B-Relative Addressing,” in this 
section. After computing the effective address, the contents of the index register are 
incremented by 1. 


In the following example of this form of B-relative addressing, $B3 contains the address 1000, 
$R2 contains the value 20A0, $R6 contains the value 2FFF, and location 30A0 contains the 
value 0001. 


Example: 
ADD $R6,$B3.+$R2 


In this example, the effective address of the data to be added to the contents of $R6 is derived 
by effectively adding the contents of the index register to the contents of $B3. The value found 
at that location (30A0) is then added to the contents of $R6, and the result (3000) is stored in 
$R6. 


After the effective address is formed, the contents of the index register are incremented by 1. 
The next time the index register is used, it will contain the value 20A1. 


When using B-relative pop addressing, only base registers $B1, $B2 or $B3 can be specified in 
the address expression. However, when stored in memory, the instruction will indicate $B5, 
$B6, or $B7, respectively, although the contents of the specified register are always used in the 
computation of the effective address. 


Figure 5-20 illustrates how the sample instruction described above is stored in memory and 
how it derives the effective address of the data to be used in the operation. 
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ASSEMBLED INSTRUCTION 
(ADD $R6,$B3. $B3.+$R2) 


LOCATION 30A0 
LOCATION 1000 (EFFECTIVE ADDRESS) 


MEMORY 


Figure 5-20. Indexed B-Relative Pop Addressing 


SHORT DISPLACEMENT ADDRESSING 


Short displacement addressing is available only for branch instructions. It is specified as 
follows: 


| ‘\ cera | 
> 


{*t temporary-label 


When this form of addressing is used, the referenced location must be within one of the ranges 
— 64 words to —1 word or +2 words to + 63 words from the location of the instruction specifying it 
(i.e., it cannot reference itself or the location following it). 


The following example illustrates the use of short displacement addressing. In the example, 
$R3 contains the value 3033 and $F is a temporary label at a location preceding the instruction 
by 24 words. 

Example: 
BODD 3,>-$F 
In this example, 3 is identified with $R3, and since its contents are an odd value, control is 


transferred to the instruction located at the memory address identified by $F (.e., $F 
preceding the instruction illustrated in the example). 


Figure 5-21 illustrates how the above example is stored in memory and how it derives the 
effective address of the location to be branched to. 


ASSEMBLED INSTRUCTION 
LABEL $F (BODD 3,>-$F) 


Figure 5-21. Short Displacement Addressing 
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SPECIALIZED ADDRESS EXPRESSIONS 
The following address expression is available for specifying an embedded control word in an 
I/O instruction. It can be used only in the second operand, and is specified as follows: 


_ jinternal-value-expression 
external-value-label 


‘The following example illustrates the use of this address form. In the example, $B3 contains 
the address 2002, which is assumed to be the address of the output control word, and it is to be 
output over channel 010. The value for sending the output control word over channel 010 is 
0405. 


Example: 
IOAA$B3,>=2'0405’ 


In the example, the output control word is extracted from location 2002, as specified by $B3, 
and sent over the desired channel. 


Figure 5-22 illustrates how the example above is stored in memory and how it derives the 
effective address of the data. 


ASSEMBLED INSTRUCTION 
(10 $B3,>=0405) 


ne ee 
LOCATION 2002 
8003 | 0405 (EFFECTIVE ADDRESS OF DATA) 


CONTROL WORD 


MEMORY 


Figure 5-22. Specialized Address Expressions 


INTERRUPT VECTOR ADDRESSING 


Interrupt vector addressing provides a convenient method by which you can examine the 
contents of the interrupt save area for the priority level at which your program is currently 
executing. (Priority levels and interrupt save areas are described in the GCOS 6 MOD 400 
System Concepts manual.) Interrupt vector addressing is specified as follows: | 


$ internal-value-expression 
’ | external-value-label 


In this form of addressing, $IV. points to the second word within the interrupt save area, and the 
value provides a displacement from the second word to another word within the interrupt save 
area. In the example below, the fifth word of the interrupt save area is loaded into R1. (Note that 
to address the second word of an interrupt save area, you require a displacement of 0, etc.) 


Example 1: 


LDR $R1,$1V. THREE 
THREE EQU 3 
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pee 


Figure 5-23 illustrates how example 1 above locates the desired memory word and places it 
into Rl. 


INSTRUCTION 
LDR $R1,$IV. THREE 


HARDWARE- INTERRUPT 
DEDICATED SAVE 
MEMORY AREA 


INTERRUPT 


VECTORS EFFECTIVE 
ADDRESS 


ASSEMBLED INSTRUCTION 
(LDR $R1,$1V.THREE) 


F Tanto] 4 


3 WORDS 


Figure 5-23. Interrupt Vector Addressing 
Example 2: 
LDB $B1,$IV.—$AF 
In Example 2, the address of the first trap save area is loaded into address register $B1. 


INDEXED ADDRESSING CONSIDERATIONS 


Table 5-1 shows available modes of indexed addressing. 


TABLE 5-1. INDEXED ADDRESSING MODES 


Mode Format 
Indexed direct IMA <label.$Rx 
Indexed indirect IMA * <label.$Rx 
Indexed direct B-relative addressing $Bn.$Rx 
Indexed indirect B-relative addressing *$Bn.$Rx 
Indirect B-relative push addressing $Bk.—$Rx 
Indexed B-relative pop addressing $Bk.+$Rx 


$Bn is any B-register, B1 through B7 
$Bk is a B-register, B1 through B3 
$Rx is an R-register, R1 through R3 


In simple cases for all indexing modes, the contents of index register $Rx are used unchanged 
in computing the effective address. In other cases certain instructions and/or machine operating 
modes may cause the value in the index register to be multiplied by 2 or 4 before being used to 
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compute the effective address. The contents of the index register is not changed after execution 
of the instruction. 


The following subsections describe how to establish this multiplication factor and which 
instructions and machine modes use a factor other than 1. 


All instructions not specifically discussed below have an indexing multiplier of 1. 


ESTABLISHING A MULTIPLICATION FACTOR 


Not all operands occupy only one word in memory. For example, LAF-configuration addresses 
occupy two words; LDI and SDI instructions manipulate 2-word operands; and scientific 
instructions may manipulate 2- or 4-word operands. 


Assume a table in memory consists of LAF addresses. The first entry in the table (entry 0) 
starts at word 0, but the third entry in the table (entry 2) starts at word 4. In general, entry n 
starts at word 2n for LAF mode addresses. With 4-word scientific operands, entry n starts at 
word 4n. 


Level 6 hardware accepts the entry number n as an indexing quantity. It multiplies that by 
the factor (1, 2, or 4) appropriate to the operand being operated on, then uses the result to find the 
word in a table where the operand begins. Thus, the general rule is to (1) determine the size of 
the operand that the instruction will operate on when it executes (i.e., one, two, or four words in 
memory), and (2) use that size as the multiplication factor for the idee register’s contents for 
this instruction in this mode. 


AID, SID, LDI, AND SDI INSTRUCTIONS 


Regardless of operating modes, the AID, SID, LDI, and SDI instructions operate on 2-word 
operands; thus their indexing multiplier is 2. 


B-REGISTER INSTRUCTIONS IN LAF CONFIGURATION 


On a 6/40 or 6/50 model in LAF configuration, addresses occupy two words in memory. Thus 
the indexing multiplier for the following B-register manipulating instructions in LAF config- 
uration is 2: LDB, STB, SWB, CMB, and CMN. In SAF configuration the multiplier is 1. (Note 
that the LAB instruction is not in this category; its indexing multiplier is always 1.) 


SCIENTIFIC INSTRUCTIONS 


On a 6/40 or 6/50 model with the SIP hardware option or any model with the SIP double- 
precision simulator, the hardware register M4 contains Scientific Instruction mode informa- 
tion, for each of the three scientific accumulators, that includes the size of its operands in 
memory, i.e., either two or four words. This size is also the indexing multiplier for any Scientific 
Instruction that references memory. 


Register M4 defines operand size separately for each accumulator. Thus the same scientific 
instruction (e.g., SLD) may have a different operand size and indexing multiplier in different 
usages within the same program. For example, the multiplier might be 2 when dealing with 
SA1, and 4 when dealing with SA3. 


Register M4, together with the operand size and indexing multiplier, can be dynamically 
changed. 


BIT/BYTE MANIPULATING INSTRUCTIONS 


The preceding discussions apply also to bit (e.g., LB) and byte (e.g., LDH) manipulating 
instructions. In these cases indexing multipliers of 1/16 or 1/2, complete with possible 
remainders, are conceivable. For example an index value of 37 in an LBF instruction would 
compute to word 2, bit 5 from the base, and be correct. However, it is more practical to consider 
the index value as simply representing the actual number of bits or bytes to be offset from the 
base. As a result, an alternative to the general rule given under “Establishing a Multiplication 
Factor” above is: In indexed addressing, measure the index value in units of the size of the 
operand with which it is operating, whether the operand unit is one bit or four words. 


ASSEMBLY LANGUAGE INSTRUCTIONS 5-26 | | | CBO07 


ACQ 


ASSEMBLY LANGUAGE INSTRUCTIONS 


The remainder of this section lists (alphabetically) and describes the assembly language 
instructions for the Central Processing Unit (CPU). Assembly language instructions for the 
Commercial Processor and the Scientific Instruction Processor (SIP) are given in Sections 6 and 
7 respectively. The description of each instruction includes the name, type, format, and explana- 
tion of operands. 


When an operand specifies a symbolic name, constant, or expression (other than an address 
expression), refer to Section 2 for a detailed description of those elements. Address expressions 
are defined in this section under “Addressing Techniques.” Before using the following 
instructions you should fully understand the assembly language elements described in Section 2 
and in this section. 


Although not shown in the source language formats, all assembly language instructions can 
be labeled. 


ACQ 

Instruction: 

Acquire stack space 
Type: 

GE 


Source Language Format: 


$Bn 
AACQA 4 X‘n’ ? ,6Rn 
n 
Description: 


This stack instruction acquires an additional frame, of the size specified by the contents of $Rn, 
from the currently available stack space. $Bn is set to point to this newly acquired frame. 


If the size specified by Rn is such that the currently available stack space is exceeded, a trap to 
trap vector 10 occurs. 


Stack instructions are double-word instructions with the following characteristics. 
e A common first word. 
e Bits 0 through 8 and bit 12 of the second word contain zeros. 
If bits 0 through 8 and bit 12 of the second word are not zero, the result is a trap to trap vector 16. 


Bits 9 through 11 of the ACQ instruction specify the register $Rn bits 13 through 15 specify 
register $Bn. 


This instruction is executable only on 6/40 and 6/50 models. 
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ADD 


ADD 
Instruction: 
Add Contents to R-register 
Type: 
DO | 
Source Language Format: 
faa | 
AADDA , X‘n’? , address-expression 
n | 
Description: 


Adds the contents of the location or R-register identified in the address expression to the 
contents of the R-register specified in the first operand. The result is saved in the first operand 
R-register. 

The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Bn| register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 


The contents of the I-register are affected as follows: 


e Ifthe result is more than 215 —1 (32767) or less than —2 (—32768), the OV-bit is set to 1: 
otherwise, it is set to 0. 


e If, during the summation, a carry occurs, the C-bit is set to 1; otherwise, it is set to 0. 
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ADV 


ADV 

Instruction: 

Add value to R-register 
Type: 

SI 


Source Language Format: 


$Rn internal-value-expression 
AADVA 34 X‘v’ { [=] ie 
a single-precision-fixed-point-constant 


Description: 


Adds the 8-bit value (with sign extended) specified in the second operand to the contents of the 
R-register identified in this operand. The result is saved in R-register. 


The contents of the I-register are affected as follows: 


e Ifthe result is more than 2—1 (82767), or less than — 2 (—32768), the OV-bit is set to 1; 
otherwise, it is set to 0. 


e If, during the summation, a carry occurs, the C-bit is set to 1; otherwise, it is set to 0. 
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AID 


AID 

Instruction: 

Add integer double 

Type: 

SO 

Source Language Format: 
AAIDAaddress-expression 

Description: 


Adds the value of the double-word integer specified by the address expression to the value in the 
register pair $R6, $R7. The result is saved in $R6 and $R7, with the most significant part in $R6 
and the least significant part in $R7. 

The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: | 


=$Bn 


=$Sn registers addressing 


Short displacement addressing 
Specialized addressing 


If the address expression specifies memory addressing with indexing, the index register is 
aligned to count double-words relative to the word specified. 


If Immediate Operand Addressing is specified, the immediate operand may only use a binary 
integer constant (which is sign extended to 32 bits by the Assembler), a double precision 
fixed-point constant, or a string constant of exactly two words (i.e., four bytes or 32 bits). 


If =$Rn is used, only =$R3 (adds the contents of R2 and R3 into R6 and R7 respectively), =$R5 
(adds the contents of R4 and R5 into R6 and R7, respectively), or =$R7 (doubles the value 
contained in R6 and R7) may be used. 


If a carry occurs, the C-bit of the I-register is set to 1, else it is set to 0. 
If overflow occurs, the OV-bit if the I-register is set to 1, else it is set to 0. 


This instruction is executable only on 6/40 and 6/50 models. 
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attire. 
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AND 


AND 

Instruction: 

AND contents with R-register 

Type 

DO 

Source Language Format: 
$Rn 

AANDA j X‘n’ > ,address-expression 

n 

Description: 


Logically AND’s the contents of the R-register identified in the first operand with the contents of 
the location or R-register specified in the address expression. The result is saved in the first 
operand R-register. 

The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


= register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 


The following chart illustrates the result of performing a logical AND operation on bits: 
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ANH 


ANH 
Instruction: 
Logically AND half-word (byte) with R-register 
Type: 
DO 
Source Language Format: 
ey 
AANHA j X‘n’} ,address-expression 
n 
Description: 


A logical AND operation is performed on the contents of the R-register identified in the first 
operand with the contents of the byte specified in the address expression. 


Prior to the operation, the byte operand is internally expanded to word length by extending the 
sign through the eight high-order bit positions. The byte selected to participate in the operation 
is determined by the format of the address expression, as follows: 

e Register Addressing (=$Rn): The rightmost byte of the register is selected. 


e Memory Addressing Without Indexing or Immediate Operand Addressing: The leftmost 
byte of the word at the designated memory address is selected. 

e Memory Addressing With Indexing: The memory address indicates a starting point. The 
index register contains an arithmetic value to be added to the starting point. The value 
specifies the number of bytes before or after the starting point needed to reach the byte 
selected for the operation. 

The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 

om register addressing 

=§$Sn j} 

Short displacement addressing 

Specialized addressing 


The following chart illustrates the result of performing a logical AND operation on bits: 


First operand bit: | 
Second p2econd operand bit: | Dat 
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coe 


ASD 


ASD 

Instruction: 

Activate Segment Descriptor 

Type: 

GE 

Source Language Format: 
AASD 

Description: 


The MMU segment descriptor whose first and second word, respectively, are contained in $R6 
and $R7 is moved into the MMU segment descriptor specified by the Effective Address contained 
in $B5. 


The ASD instruction is privileged. 


Segment descriptors are entries in physical memory allocation tables which relate physical 
memory allocations to specific process usages. Segment descriptors are used to specify the 
resources available to a particular process under the memory protection subsystem. 


This instruction is available only with systems that have a Memory Management Unit. 
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B 


B 

Instruction: 

Branch unconditionally 
Type: 

BI 


Source Language Format: 


direct-IMA 
ABA (<direct-P-relative-address 
short-displacement-address 


Description: 
Branches unconditionally to the location specified in the operand. 


Ifthe J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 2. 
Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequences starting at the 
location specified by the operand is executed. 
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BAG 


BAG 


Instruction: 

Branch if algebraically greater than 
Type: 

BI 


Source Language Format: 


direct-IMA 
ABAGA 4 direct-P-relative-address 
short-displacement-address 


Description: 

Branches to the location specified in the operand if either, but not both, of the G- or U- bits of the 
J-register equals 1. 

Action if Branch Occurs: 


If the J-bit in the M1-register contains binary 1, the trace procedure is entered via trap vector 2. 
Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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BAGE 


BAGE 
Instruction: 
Branch if algebraically greater than or equal to 
Type: 
BI 
Source Language Format: 


direct-IMA 
ABAGEA 4 direct-P-relative-address 
short-displacement-address 


Description: 


Branches to the location specified in the operand if the U- and L-bits of the I-register are both 0 or 


both 1. 


Action if Branch Occurs: 


If the J-bit in the M1-register contains binary 1, the trace procedure is entered via trap vector 2. 
Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 


location specified by the operand is executed. 
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BAL 


BAL 

Instruction: 

Branch if algebraically less than 
Type: 

BI 


Source Language Format: 


direct-IMA 
ABALA j direct-P-relative-address 
short-displacement-address 


Description: 

Branches to the location specified in the operand if either, but not both, of the U- or L-bits of the 
I-register equals 1. 

Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 


ASSEMBLY LANGUAGE INSTRUCTIONS 5-37 CBO7 


BALE 


BALE 
Instruction: © 

Branch if algebraically less than or equal to 
Type: 

BI 


Source Language Format: 


direct-IMA 
ABALEA { direct-P-relative-address 
short-displacement-address 


Description: 


Branches to the location specified if the G- and U-bits of the I-register are both 0 or both 1. 


Action if Branch Occurs: 


Ifthe J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 


location specified by the operand is executed. 
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BBF 


BBF 

Instruction: 

Branch if bit-test indicator false 
Type: 

BI 


Source Language Format: 
direct-IMA 
ABBFA 4 direct-P-relative-address 
short-displacement-address 
Description: 
Branches to the location specified in the operand if the B-bit in the I-register is set to 0. 


Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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BBT 


BBT 

Instruction: 

Branch if bit-test indicator true 
Type: 

BI 


Source Language Format: 


direct-IMA 
ABBTA {4 direct-P-relative-address 
short-displacement-address 


Description: 


Branches to the location specified in the operand if the B-bit in the I-register is set to 1. 


Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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BCF 


BCF 

Instruction: | 

Branch if no carry 

Type: 

BI 

Source Language Format: 


direct-IMA 
ABCEA j¥ direct-P-relative-address 
short-displacement-address 


Branches to the location specified in the operand if the C-bit in the I-register is set to 0. 
Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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BCT 


BEE Ne 
al 


BCT 

Instruction: 

Branch if carry 

Type: 

BI 

Source Language Format: 


direct-IMA | 
ABCTA 4 direct-P-relative-address 
short-displacement-address 


Description: 
Branches to the location specified in the operand if the C-bit in the I-register is set to 1. 
Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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BDEC 


BDEC 

Instruction: 
Branch and decrement 
Type: 

BR 

Source Language Format: 


$Rn direct-IMA 
ABDECA 4 X‘n’ } , | direct-P-relative-address 
n short-displacement-address 
Description: 


Subtracts 1 from the contents of the R-register identified in the first operand; then, branches to 
the location specified in the second operand if the contents of the R-register are not equal to —1. 


Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 


? 
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BE 


BE 

Instruction: 
Branch if equal 
Type: 

BI 


Source Language Format: 


direct-IMA 
ABEA j direct-P-relative-address 
short-displacement-address 
Description: 


Branches to the location specified in the operand if both the G- and L-bits of the I-register are set 
to 0. | 
Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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BEVN 


BEVN 

Instruction 

Branch if R-register even 
Type: 

BR 


Source Language Format: 


$Rn) { direct-IMA 
ABEVNA { X‘n’}, \ direct-P-relative-address 
n _short-displacement-address 


Description: 

Branches to the location specified in the second operand if the R-register identified in the first 
operand contains an even value. 

Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. | 
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BEZ 


BEZ 

Instruction: 

Branch if R-register equal to 0 
Type: 

BR 


Source Language Format: 


$Rn direct-IMA 
ABEZA 4 X‘n’}, \ direct-P-relative-address 
n short-displacement-address 


Description: 


Branches to the location specified in the second operand if the R-register identified in the first 
operand contains 0. 


Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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BG 


BG 

Instruction: 

Branch if greater than 
Type: 

BI 

Source Language Format: 


direct-IMA 
ABGA 4 direct-P-relative-address 
short-displacement-address 


Description: 
Branches to the location specified in the operand if the G-bit of the I-register is set to 1. 
Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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BGE 


BGE 
Instruction: 
Branch if greater than or equal to 
Type: 
BI 
Source Language Format: 


direct-IMA 
ABGEA } direct-P-relative-address 
short-displacement-address 


Description: 
Branches to the location specified in the operand if the L-bit of the I-register is set to 0. 
Action if Branch Occurs: | 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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exe 


BGEZ 


BGEZ 


Instruction: 
Branch if R-register greater than or equal to 0 


Type: 
BR 


Source Language Format: 


‘$Rn { direct-IMA 
ABGEZA j} X‘n’/ , sdirect-P-relative-address 
n \short-displacement-address 


Description: 

Branches to the location specified in the second operand if the R-register identified in the first 
operand contains a positive value or 0. 

Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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BGZ 


BGZ sae 
Instruction: | | a 
Branch if R-register greater than 0 
Type: 

BR 


Source Language Format: 


$Rn direct-IMA 
ABGZA ) X‘n’ 7, } direct-P-relative-address 
n short-displacement-address 


Description: 

Branches to the location specified in the second operand if the R-register identified in the first 
operand contains a positive value. 

Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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BINC 


Instruction: 
Branch and increment 
Type: 

BR 


Source Language Format: 


$Rn direct-IMA 
ABINCA 4 X‘n’/; } direct-P-relative-address 
n short-displacement-address 


Description: 
Adds 1 to the contents of the R-register identified in the first operand; then, branches to the 
location specified in the second operand if the contents of the R-register is not 0. 


Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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BIOF 


BIOF 
Instruction: | 
Branch if I/O indicator false 
Type: 
BI 


Source Language Format: 


direct-IMA 
ABIOFA 4 direct-P-relative-address 
short-displacement-address 


Description: 


Branches to the location specified in the operand if the I-bit in the I-register is set to 0. 


Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 


location specified by the operand is executed. 
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BIOT 


BIOT 

Instruction: 

Branch if I/O indicator true 
Type: 

BI 

Source Language Format: 


direct-IMA 
ABIOTA j direct-P-relative-address 
short-displacement-address 


Description: 
Branches to the location specified in the operand if the I-bit in the I-register is set to 1. 


Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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BL 


BL 
Instruction: 
Branch if less than 
Type: 

BI 


Source Language Format: 


direct-IMA 
ABLA direct-P-relative-address 
short-displacement-address 


Description: 
Branches to the location specified in the operand if the L-bit of the I-register is set to 1. 
Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 


operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 


location specified by the operand is executed. 
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BLE 


BLE 


Instruction: 

Branch if less than or equal to 
Type: 

BI 


Source Language Format: 


direct-IMA 
ABLEA direct-P-relative-address 
short-displacement-address 


Description: 
Branches to the location specified in the operand if the G-bit of the I-register is set to 0. 
Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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BLEZ 

Instruction: 

Branch if R-register equal to or less than 0 
Type: 

BR 


Source Language Format: 


$Rn) (direct-IMA 
ABLEZA 4 X‘n’?, 4 direct-P-relative-address 
n short-displacement-address 


Description: 

Branches to the location specified in the second operand if:the R-register identified in the first 
operand contains a negative value or 0. 

Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 

2. Upon completion, the trace procedure automatically branches to the address specified by the 

operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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BLZ 


Instruction: 
Branch if R-register less than 0 
Type: 

BR 


Source Language Format: 


$Rn} {direct-IMA 
ABLZA 4 X‘n’}, } direct-P-relative-address 
n short-displacement-address 


Description: 

Branches to the location specified in the second operand if the R-register identified in the first 
operand contains a negative value. 

Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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BNE a 
Instruction: | | ee 
Branch if not equal 

Type: 

BI 


Source Language Format: 


direct-IMA 
ABNEA jdirect-P-relative-address 
short-displacement-address 


Description: 

Branches to the location specified in the operand if either, but not both, the G-bit or the L-bits of 
the I-register are set to 1. 

Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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BNEZ 


BNEZ 


Instruction: 
Branch if R-register not equal to 0 


Type: 
BR 


Source Language Format: 


$Rn) {direct-IMA 
ABNEZA 4 X‘n’}, jdirect-P-relative-address 
n short-displacement-address 


Description: 
Branches to the location specified in the second operand if the R-register identified in the first 
operand contains a value other than 0. 


Action if Branch Occurs: 
If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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BNOV 


BNOV 


Instruction: 

Branch if no R-register overflow 
Type: 

BI 


Source Language Format: 


direct-IMA 
ABNOVA jdirect-P-relative-address } 
short-displacement-address 


Description: 
Branches to the location specified in the operand if the OV-bit in the I-register is set to 0. 
Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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BODD 


BODD 


Instruction: 
Branch if R-register odd 


Type: 
BR 


Source Language Format: 


$Rn direct-IMA 
ABODDA j X'n’{ , } direct-P-relative-address 
n short-displacement-address 


Description: 

Branches to the location specified in the second operand if the R-register identified in the first 
operand contains an odd value. 

Action if Branch Occurs: 

If the J-bit in the M1-register contains a binary i the trace procedure is entered via trap vector 


2. Upon completion, the trace procedure automatically branches to the address specified by the 


operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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Instruction: 

Branch if R-register overflow 
Type: 

BI 

Source Language Format: 


direct-I[MA 
ABOVA j direct-P-relative-address 
short-displacement-address 


Description: 
Branches to the location specified in the operand if the OV-bit in the I-register is set to 1. 
Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 


mes 


ASSEMBLY LANGUAGE INSTRUCTIONS 5-62 CBO7 


BRK 

Instruction: 

Break trap 

Type: 

GE 

Source Language Format: 


ABRKA 


Description: 


BRK 


Enters the trace procedure by a trap to trap vector 2; this instruction is used for debugging. 
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BSE 


BSE 

Instruction: 

Branch if signs equal 
Type: 

BI 

Source Language Format: 


_{direct-IMA 7 
ABSEA { direct-P-relative-address 
short-displacement-address 


Description: 
Branches to the location specified in the operand if the U-bit in the I-register is equal to 0. 
Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. | 
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BSU 

Instruction: 

Branch if signs unlike 
Type: 

BI 


Source Language Format: 


( direct-IMA 
ABSUA { direct-P-relative-address 
short-displacement-address } 
Description: 


Branches to the location specified in the operand if the U-bit in the I-register is equal to 1. 


Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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CAD 


CAD jer 


Instruction: a: 


Add carry bit to contents 


Type: 

SO 

Source Language Format: 
ACAD4Aaddress-expression 


Description: 


Adds the contents of the C-bit in the I-register to the contents of the location Pee in the 
address expression. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


ion register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 


The contents of the I-register are affected as follows: 


e Ifacarry occurs during the operation, the C-bit is set to 1; otherwise, it is set to 0. 


e Ifthe result is more than 215—1 (32767), or less than —215 (— 32768), the OV-bit is set to 1; 
otherwise, it is set to 0. 
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CL 


CL 


Instruction: 
Clear 


Type: 
SO 
Source Language Format: 
ACLAaddress-expression 
Description: 
Stores zeros in the location or R-register specified in the address expression. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


ae register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 
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CLH 


CLH | 3 oo 
Instruction: | : | a / 
Clear half-word | 

Type: 

SO. 


Source Language Format: 
ACLHAaddress-expression 
Description: | 
Stores 0’s in the half-word (byte) location specified in the address expression. 
The byte to be cleared is determined by the format of the address expression, as follows: 


e If the address expression specifies Register Addressing (=$Rn), 0’s are stored in the 
rightmost byte of the register. 


e If the operand specifies Memory Addressing without indexing, or Immediate Operand 
Addressing 0’s are stored in the leftmost byte of the word found at the specified location. 


e Ifthe operand specifies Memory Addressing with indexing, the index register is aligned to 
count bytes relative to the leftmost byte ofthe word specified. 0’s are stored in the byte thus 
addressed. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Bn register addressing 
Short displacement addressing | 
Specialized addressing | . 
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CMB 


CMB 

Instruction: 

Compare contents to B-register 
Type: 

DO 


Source Language Format: 
$Bn 
ACMBA j X‘n’ { , address-expression 
n 
Description: 


Compares the contents of the B-register identified in the first operand to the contents of the 
location or B-register specified in the address expression. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Rn| register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 


Immediate operand addressing with a value expression. 
The contents of the I-register are affected as follows: 
e Ifthe contents ofthe B-register are greater than the contents of the location, the G-bit is set 
to 1; otherwise, it is set to 0. 


e Ifthe contents of the B-register are less than the contents of the location, the I-bit is set to 1; 
otherwise, it is set to 0. 


e The setting of the U-bit is undefined. 
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CMH 


Instruction: 


Compare half-word (byte) to R-register 


Type: 
DO 
Source Language Format: 
$Rn , 
ACMHA , X‘n’? , address-expression 
n 
Description: 


Compares the contents of the R-register identified in the first operand to the contents of the byte 


specified in the address expression. 


Prior to the operation, the byte operand is internally expanded to word length by extending the 
sign through the eight high-order bit positions. The byte selected to participate in the operation 
is determined by the format of the address expression, as follows: 


e Register Addressing (=$Rn): The rightmost byte of the register is selected. 


e Memory Addressing Without Indexing or Immediate Operand Addressing: The leftmost 
byte of the word at the designated memory address is selected. 


e Memory Addressing With Indexing: The memory address indicates a starting point. The 
index register contains an arithmetic value to be added to the starting point. The value 
specifies the number of bytes before or after the starting point needed to reach the byte 


selected for the operation. 


The address expression can take any of the forms described earlier in this section under 


“Addressing Techniques,” except for the following: 


=$Bn| register addressing 
=$Sn | 
Short displacement addressing 
Specialized addressing 


The contents of the I-register are affected as follows: 


e Ifthe contents of the R-register are greater than the contents of the created temporary 
word, the G-bit is set to 1; otherwise, it is set to 0. 


e Ifthe contents of the R-register are less than the contents of the created temporary word, 
the L-bit is set to 1; otherwise, it is set to 0. 


e Ifthe contents of the R-register and the contents of the created temporary word do not have 
like signs, the U-bit is set to 1; otherwise, it is set to 0. 
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CMN 


CMN 

Instruction: 

Compare address to null 

Type: 

SO 

Source Language Format: 
ACMNAaddress-expression 

Description: 


Compares the contents of the location or B-register specified by the address expression to a null 
address (the address 0). 


The contents of the I-register are affected as follows: 


e The G-bit is set to 0 if the contents of the specified location or register are equal to null; 
otherwise, it is set to 1. 


e The L-bit is set to 0. 
e The U-bit is affected, but its value is undefined. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


on register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 


Immediate operand addressing with a value expression. 


ASSEMBLY LANGUAGE INSTRUCTIONS 5-71 | CBO7 


CMR 


CMR 

Instruction: 

Compare contents to R-register 
eis | : 

DO- 

Source Language Format: 


$Rn 
ACMRA j X‘n’}? , address-expression 
n 
Description: 
Compares the contents of the R-register identified in the first operand to the contents of the 
location or R-register specified in the address expression. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


= — register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 


The contents of the I-register are affected as follows: 


e Ifthe contents of the R-register are greater than the contents of the location, the G-bit is set 
to 1; otherwise, it is set to 0. 


e Ifthe contents of the R-register are less than the contents of the location, the L-bit is set to 
1; otherwise, it is set to 0. 


e Ifthe content of bit 0 of the R-register is not equal to the content of bit 0 of the location, the 
U-bit is set to 1; otherwise, it is set to 0. 
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CMV 


C CMV 


- Instruction: 
Compare value to R-register 
Type: 
SI 


Source Language Format: 


oe internal-value-expression 
ACMVA 4 X‘n’? ,[=]§_; ag : 
= single-precision-fixed-point-constant 


Description: 


Compares the 8-bit value (with sign extended) specified in the second operand to the contents of. 
the R-register identified in the first operand. 


The contents of the I-register are affected as follows: 


e Ifthe contents of the R-register are greater than the value (with sign extended), the G-bit is 
set to 1; otherwise, it is set to 0. 


e Ifthe contents of the R-register are less than the value (with sign extended), the L-bit is set 
to 1; otherwise, it is set to 0. 


e Ifthe sign of the R-register and the sign of the value are not equal, the U-bit is set to 1; 
otherwise, it is set to 0. 


ASSEMBLY LANGUAGE INSTRUCTIONS 5-73 | CBO7 


CMZ 


CMZ 
Instruction: 
Compare to 0 a 
Type: 
SO 
Source Language Format: 
ACMZAaddress-expression 


Description: | 

Compares the contents of the location or R-register specified in the address expression to 0. 
The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Bn| register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 


Note that, the $Bn.$R1, $Bn.$R2, or $Bn.$R3 form of addressing can be used by this instruction 
to cause a trap for the purpose of sizing main memory. 


The contents of the I-register are affected as follows: 


e Ifthe contents ofthe specified location do not equal 0, the G-bit is set to 1; otherwise, it is set 
to 0. 


e The L-bit is set to 0. 
e Ifthe first bit of the specified location equals 1, the U-bit is set to 1; otherwise, it is set to 0. 
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CNFG 


CNFG 


Instruction: 


Configure 


Type: 
GE 


Description: 
Causes the CPU to perform an input/output operation and a scan. 


The effect of the input/output operation is equivalent to that produced by the execution of the 
following instruction: 


=$R7,=$R6 


Register R6 contains the command word (CH,F) that specifies a channel number and a function 
code. (See the IO instruction, for format of the command word.) The function code must 
designate an output function. The command word and the word contained in register R7 are sent 
to the addressed IO channel. 


A predetermined list of channel numbers is scanned to determine the presence or absence of 
optional processors. The results of the scan are used to update internal CPU firmware/hardware 
flags that direct instruction execution; 1.e., trap or execute by an optional processor. An identical 
scan is performed automatically when the system is powered up or initialized. 


This privileged instruction, which is executable only on 6/40 and 6/50 models, is normally used 
to control the configuration of option boards; e.g., the Commercial Processor and the SIP. 
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CPL 


CPL | _ 


Instruction: | | aw 
Complement 

Type: 

SO 


Source Language Format: 
-ACPLAaddress-expression 
Description: — 
One’s complements the contents of the location or R-register specified in the address expression. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: | 
aa register addressing 
=$Sn 
Short displacement addressing 
Specialized addressing 


The following chart illustrates the result of logically one’s complementing bits: 


Na r. : 
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DAL 


DAL 

Instruction: 

Double-shift arithmetic-left 
Type: 

SHL 


Source Language Format: 


“A 


3 
ADALA x' f ’ 7 ,internal-value-expression 


| 
3 
5 
7 
Description: 


Left shifts the contents of the even-odd R-register pair (i.e., R2 and R3, R4 and R35, R6 and R7) 
identified in the first operand the number of bit positions specified by the -internal value 
expression in the second operand. The bit positions vacated by the shift are filled with binary 0’s. 


The internal value expression must be = 0 and = 31. 


If the internal value expression equals 0, the contents are shifted left the number of bit positions 
derived by using the value in bits 11 through 15 of general register R1. 


The contents of the I-register are affected as follows: 


¢ If the contents of bit 0 in the even-numbered R-register changes at any time during the 
operation, the OV-bit is set to 1; otherwise, it is set to 0. 


The following illustrates the operation of the DAL instruction: 


Set to 1 if Rn’ (0) changes during the operation. 
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DAR 


DAR | x 
Instruction: | a 
Double-shift arithmetic-right 

Type: 

SHL 


Source Language Format: 


“A 


| 3 
ADARA x' | ’ 7 ,internal-value-expression 


a 


Description: . | 


Shifts the contents of the even-odd R-register pair (i.e., R2 and R3, R4 and R5, R6 and R7) 
identified in the first operand right the number of bit positions specified by the internal value 
expression in the second operand. The bit positions vacated by the shift are filled with the sign 
value originally contained in bit 0. 


The internal value expression must be = 0 and = 31. 


If the internal value expression equals 0, the contents are shifted left the number of bit positions 
derived by using the value in bits 11 through 15 of general register R1. | 


The contents of the I-register are affected as follows: 


e C-bit contains the last binary digit shifted out of the odd-numbered R-register. 
The following illustrates the operation of the DAR instruction: 


| 0 Rn’ 15 0 Rn 15 
ee 


Saves last bit shifted out of Rn (15). 
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DCL 


DCL 

Instruction: 
Double-shift closed-left 
Type: 

SHS 


Source Language Format: 


at 


3 
ADCLAY X' 5 ’ Zinternal-value-expression 


7 
3 
D 
7 
Description: 


Shifts the contents of the even-odd R-register pair (i.e., R2 and R3, R4 and R5, R6 and R7) 
identified in the first operand left the number of bit positions specified by the internal value 
expression in the second operand. The bits shifted out of the even-numbered R-register are 
placed in the bit positions of the odd-numbered R-register vacated as the bits are shifting left. 


The internal value expression must be = 0 and < 15. 
Note that the DCL instruction is short shift. 


The following illustrates the operation of the DCL instruction: 


0 Rn’ 15 0 Rn 15 : 
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DCR 


DCR Pat 
Instruction: a oe 
Double-shift closed-right 

Type: 

SHS 


Source Language Format: 


=f 


3 
ADCRA © 5 ’ 7,internal-value-expression 


fy 


Description: 7 


Shifts the contents of the even-odd R-register pair (i.e., R2 and R3 R4 and Rd, R6 and R7) 
identified in the first operand right the number of bit positions specified by the internal value 
expression in the second operand. The bits shifted out of the odd-numbered R-register are placed 
in the bit positions of the even-numbered R-register vacated as the bits are shifting right. 


The internal value expression must be = 0 and < 15. 


If the internal value expression equals 0, the contents are shifted right the number derived by 
using the value in bits 11 through 15 of general register R1. 


Note that the DCR instruction is short shift. 
The following illustrates the operation of the DCR instruction: 
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DEC 


DEC 

Instruction: 

Decrement 

Type: 

SO 

Source Language Format: 
ADECAaddress-expression 


Description: 

Decrements by 1 the contents of the location or R-register specified in the address expression, 
then copies bit 0 of the addressed word or register into I[(B). 

This instruction operates in read modify write (RMW) mode, which prevents any Gia processor 
in a multiprocessor environment from accessing the location being modified until the modifica- 
tion is completed. , 

The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


= register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 


The contents of the I-register are affected as follows: 


e Ifthe decrementation causes a carry to occur (i.e., the value being decremented was not 
zero), the C-bit is set to 1; otherwise, it is set to 0. 


e Ifthe value being decremented was —32768 (—2”), I(OV) is set to 1; otherwise, I (OV) is 
cleared to 0. 


e I(B) is set as described above. 
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DIV 


DIV 

Instruction: 

Divide R-register by contents of location 
Type: 

DO 

Source Language Format: 


$Rn 
ADIVA 4 X‘n’; ,address-expression 
n 


Description: 


Divides the contents of the R-register identified in the first operand by the contents of the 
location or R-register specified in the address expression. The quotient is saved in the first 
operand R-register. The remainder is ignored. 


If R7 is identified as the first operand R-register, the double integer operand contained in R6 and 
R7 is divided by the single integer operand identified by the address expression. The quotient is 
saved in R7 and the remainder is saved in R6. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Bn| register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 


The contents of the I-register are affected as follows: 


1. I(OV) is set to 1 if 
a. The divisor = 0 


b. The quotient is greater than 2” —1 (32767) or less than —2" (—32768). 


Otherwise I(OV) is cleared to 0. 


Divide operations that cause I(OV) to be set will terminate with all operands unchanged. 


2. I(C) is set to 1 if the remainder is not 0, or cleared to 0 if the remainder is 0. I(C) is 
~ unchanged when the first operand is $R7. If the divisor = 0 or if the dividend is —2" times 


the divisor, I(C) is undefined. 
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( ~ 


DOL 
DOL 
Instruction: 
Double-shift open-left 


Type: 
SHL 


Source Language Format: | 


a 


3 
ADOLA X' 5 */ ,internal-value-expression 


7 
3 
5 
7 
Description: 


Shifts the contents of the even-odd R-register pair (i.e., R2 and R3, R4 and Rd, R6 and R7) 
identified in the first operand left the number of bit positions specified by the internal value 
expression in the operand. The bit positions vacated by the shift are filled with binary 0’s. 


The internal value expression must be 2 0 and < 31. 


If the internal value expression equals 0, the contents are shifted left the number derived by 
using the value in bits 11 through 15 of general register R1. 


The contents of the I-register are affected as follows: 
e C-bit contains the last binary digit shifted out of the even-numbered R-register. 


The following illustrates the operation of the DOL instruction: 


0 Rn’ 15 0 Rn 15 
a a 


Saves last bit shifted out of Rn’ (0). 
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DOR 


DOR | goo 
Instruction: | | Pa: 
Double-Shift open-right 
Type: 
SHL 
Source Language Format: 
3 
$R 45 
7 
3 
ADORA X* 45>) ’ /,internal-value-expression 
7 
3 
5 
7 
Description: 
Shifts the contents of the even-odd R-register pair (i.e., R2 and R3, R4 and R5d, R6 and R7) 
identified in the first operand right the number of bit positions specified by the internal value 
expression in the operand. The bit positions neemee ” the shift are filled with binary 0’s. 
The internal value expression must be = 0 and < | 
If the internal value expression equals 0, the contents — shifted right the number derived by 
using the value in bits 11 through 15 of general register R1. 
The contents of the I-register are affected as follows: — 
e C-bit contains the last binary digit shifted out of the odd-numbered ee rd 
The following illustrates the operation of the DOR instruction: 
0 Rn’ 15 0 Rn 15 
0 — — | rll 
Saves last bit shifted out of Rn (15). 
Soy 
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DQA 


DQA 

Instruction: 

Dequeue on address 

Type: 

GE 

Source Language Format: 
ADQA 

Description: 


This instruction unlinks a frame whose PRIORITY word address exactly matches the address 
contained in register B1. Register B2 points to the LOCK word. 


If the instruction is not successfully completed, the carry bit of the indicator register is cleared to 
zero; otherwise it is set to one and the G- and L-bits indicate the results as follows: 


Indicator Register Bit 
G L Result 
0 0 Frame was unlinked 
0 1 No match found 


Queue instructions can be executed only on model 6/40 and 6/50 systems. 
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DQH 


DQH 
Instruction: 
Dequeue from head 
Type: 

GE 
Source Language Format: | 

ADQH 

Description: | 
This instruction unlinks the first frame whose priority is equal to or numerically greater than 


that specified by register R5. Register B2 points to the LOCK word. If the instruction is not 
- completed, the carry bit of the indicator register is cleared to zero. If the instruction is completed: 


e The carry bit of the indicator register is set to one 
e The pointer tothe PRIORITY word ofthe unlinked frame, if any, is loaded into register B1 
e The G- and L- bits of the indicator register indicate the results as follows: 


Indicator Register Bits 


G L Results 

0 0 Unlinked frame was first whose priority equalled that 
specified by register R5. | 

1 0 Unlinked frame was first whose priority number was 
greater than that specified by register R5. 

0 1 No frame was unlinked; register B1 is unchanged; no 


frame found whose priority number was equal to or 
greater than that specified by register R5. 


Queue instructions can be executed only on model 6/40 and 6/50 systems. 
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ly 9 27 


ENT 


ENT 

Instruction: 

Enter 

Type: 

sO | 

Source Language Format: 


immediate-memory-address 
B-relative-addressing 
P-relative-addressing 
interrupt-vector-addressing 


AENTA 


Description: 


Jumps to the memory location specified by the operand; also, sets the P-bit or the high order bit 
of the ring field in the S-register, as appropriate, to 0 (i.e., sets the bit to indicate the un- 
privileged state). 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, or if the J-bit contains a binary 0, execution commences at the specified 
location. 
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HLT 


HLT | | a 

Instruction: bs 

Halt 

Type: 

GE 

Source Language Format: 
AHLT 


‘Description: 


Stops program execution. HLT state is indicated on the control panel. All interrupts are 
honored. | 


The P-bit of the S-register must be set to 1, or the ring field of the S-register must be set to 1x, 
whichever is appropriate; i.e., the central processor must be in the privileged state for this 
instruction to be executed. If not, the unprivileged use of a privileged operation results in a trap 
to trap vector 13. 


A halt instruction on a user level may prevent a lower priority user level from completing a 
Monitor service operation. The Monitor may be interrupted in a way that causes a system 
interlock. If user level halts are used during program development, the level specified should be 
the lowest priority in the system. 


ASSEMBLY LANGUAGE INSTRUCTIONS —_—_ 5-88 _ | CBO07 


INC 


INC 

Instruction: 

Increment 

Type: 

~ SO 

Source Language Format: 
AINCAaddress-expression 

Description: 


Copies bit 0 of the contents of the location or R-register specified in the address expression into 
I(B), then increments by 1 the contents of the location or register. 


This instruction operates in read modify write (RMW) mode, which prevents any other processor 
_in a multiprocessor environment from accessing the location being modified until the 
modification is completed. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Bn| register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 


The contents of the I-register are affected as follows: 


e Ifthe incrementation causes a carry to occur (i.e., the value being incremented was —1), 
the C-bit is set to 1; otherwise, it is set to 0. 


e Ifthe value being incremented was 32767, I(OV) is set to 1; otherwise, it is cleared to 0. 
e I(B) is set on as described above. 
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IO 


ie) 


Instruction: 
Input/Output (word) 


Type: 
IO 


Source Language Format: 
AlOAaddress-expression,address-expression 


Description: 


1. If the function code (F) is odd (indicating output): sends the command word (CH,F) 
specified by the second operand and the word specified by the first operand to the 
~ addressed IO channel. 


2. If the function code (F) is even (indicating input): sends the command word (CH,F) 
specified by the second operand to the addressed channel. If the channel accepts the 
command, receives a word response from the channel and stores it in the word location or 
R-register specified by the first operand. If the channel does not accept the command, the 
contents of the location or register remain unchanged. 

In both cases above, if the IO channel accepts the command, the I-bit in the indicator register is 
set to binary 1. | | 
For the first operand, the address expression can take any of the forms described earlier in this 
section under “Addressing Techniques,” except for the following: 
=$Bn) register addressing 
—=$Sn 
Short displacement addressing 
Specialized addressing 


For the second operand, the address expression can take any of the forms described earlier in 
this section under “Addressing Techniques,” except for the following: 

ny register addressing 

=$Sn 

Short displacement addressing 
The channel number and function code are contained in the R-register or memory word specified 
by the second operand. The channel number and function code occupy 16 bits formatted as 
follows: | 


Bru: 0 910 ee 


CH is the channel number and F is the function code. The channel number is odd for output 
(memory-to-device) transfer and even for input (device-to-memory) transfer. The function code 
is controller-specific, subject to these constraints: 
1. If F is odd, data (specified by the first operand) is transferred from the CPU to the 
controller. 
2. IfF is even, data is transferred from the controller to the CPU, which stores the data in the 
R-register or memory word specified by the first operand. 


ASSEMBLY LANGUAGE INSTRUCTIONS _—_ 5-90 y 8 | CBO7 


IO 


The following shows how the required channel number and function code are used. Assume that 
c : the status of a read operation on channel 20,, is to be stored into the word labeled STATUS. Also 
a, assume that the controller uses the standard function code 18, , for “input status register.” The IO 
instruction to accomplish this could be coded as shown below: 


IO STATUS, >=Z'0818’ 
or it could be coded as: 
IO STATUS, >=X‘20* 64+ X'18’ 
For detailed information on the bus, refer to the Honeywell Level 6 Minicomputer Handbook. 
The contents of the I-register are affected as follows: | 
e Ifthe controller accepted the command, the I-bit is set to 1; otherwise, it is cleared to 0. 
The IO instruction is privileged. 
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IOH 


IOH 

Instruction: 

Input/output half-word 
Type: 

IO 

Source Language Format: 


AlOHAaddress-expression,address-expression 


Description: 


This instruction is identical to oe 10 instruction, ee that the first operand specifies a 
half-word as follows: 


e Ifit specifies =$Rn, the rightmost byte of the specified R-register is sent (i.e., function code 
is odd) to the bus. 


e Ifit specifies Memory Addressing without indexing, or an Immediate Operand Addressing 
format, the leftmost byte of the word found at the specified location is sent (i.e., function 
code is odd) to the bus. 


e If it specifies Memory Addressing with indexing, the index register is aligned to count 
bytes relative to the leftmost byte of the word specified. The byte thus addressed is sent 
(1.e., function code is odd) to the bus. 


For each of the above cases, if the function code is even, the first operand specifies the byte in 
which the response from the bus is to be stored. 


See the description of the IO instruction for details regarding the coding of the operands. 
The IOH instruction is privileged. 
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IOLD 


 . Instruction: 


Input/output load 


Type: 
0) 


Source Language Format: 


AIOLDAaddress-expression,address-expression,address-expression 


Description: 


Sends the controller the effective address (specified by the first operand), the channel number 
and function code (specified in the second operand), and the range (i.e., number of bytes to be 
transferred) value (specified in the third operand) over the channel specified in the second 
operand to the bus. The address and range value are used to load the controller address and 
range registers. 


For the first operand, the address expression can take any of the forms described earlier in this 
‘section under “Addressing Techniques” except for the following: 
=$Bn 
= | register addressing 
_ =$Sn | 
Short displacement addressing ‘ 
Specialized addressing 
Immediate operand addressing 


7 | For the second operand, the address expression can take any of the ovens described earlier in 
( this section under “Addressing Techniques,” except for the following: 
| =$Bn 
=$Sn 
Short displacement addressing 


| register addressing’ 


_ The second operand of this instruction must specify the function sue 09, for most controllers. 


For the third operand, the address expression can take any of the forms described earlier in this 
section under “Addressing Techniques” except for the following: 
=$Bn 
=$Sn 
Short displacement addressing 
Specialized addressing 


register addressing 


The following shows how the required channel number and function code are used. Assume that 
128 bytes are to be read from the device on channel 20,, into the buffer labeled BUFFER. The 
IOLD instruction to output this information to the controller could be coded as shown below: 


IOLD BUFFER, >=Z'0809’,= 128 
For detailed information about the bus, see the Honeywell Level 6 Minicomputer Handbook. 
The contents of the I-register are affected as follows: 

e Ifthe channel accepted the command, the I-bit is set to 1; otherwise, it is set to 0. 


The IOLD instruction is privileged. 
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JMP 


JMP 
Instruction: 
Jump 
Type: 
SO 
Source Language Format: 


immediate-memory-address 
B-relative-addressing 
P-relative-addressing 
interrupt-vector-addressing 


AJMPA 


Description: 
Jumps to the location specified in the operand. 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, or if the J-bit contains a binary 0, execution commences at the specified 
location. 
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LAB 

Instruction: 

Load effective address into B-register 
Type: 

DO 


Source Language Format: 


$Bn 
ALABA j X‘n’? ,address-expression 
n 


Description: 


Loads the effective address generated by the address expression into the B-register identified in 
the first operand. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


e Register addressing 
e Short displacement addressing 


e Specialized addressing 


NOTE: The Level 6 hardware does not consider LAB to be a base register instruction. 
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LB 


LB 


Instruction: 
Load bit 


Type: 
SO 


Source Language Format: 
internal-value-expression 


ALBAaddress-expression |, } external-value-expression 
single-precision-fixed-point-constant 
Description: 

1. Ifthe first operand specifies indexing, the index register is aligned to count bits relative to 
bit 0 of the specified word. The bit thus addressed is loaded into the B-bit of the I-register. 
The second operand must be omitted when the first operand specifies indexing. 

2. If the first operand does not specify indexing, the value (mask) in the second operand 
identifies which bit(s) are to be checked (e.g., Z‘8000’ indicates that the first bit of the word 
found at the specified location is to be checked); then, if (any of) the specified bit(s) contain 
a binary 1, the B-bit of the I-register is set to 1; otherwise, it is set to 0. If the value of the 
second operand is zero, the contents of $R1 are used as a mask. 

The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Bn| register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 
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LBC 


. Instruction: 


Load bit and complement 


Type: 
SO 


Source Language Format: 


internal-value-expression 
ALBCAaddress-expression |, { external-value-expression 
single-precision-fixed-point-constant 


Description: 


1. Ifthe first operand specifies indexing, the index register is aligned to count bits relative to 
bit 0 of the specified word. The bit thus addressed is loaded into the B-bit of the I-register. 
Upon completion of the operation, the addressed bit is set to the one’s complement of its 
value. The second operand must be omitted when the first operand specifies indexing. 


2. Ifthe first operand does not specify indexing, the value (mask) in the second operand 
identifies which bit(s) are to be checked (e.g., Z°8000’ indicates that the first bit of the word 
found at the specified location of R-register is to be checked); then, if (any of) the specified 
bit(s) contains a binary 1, the B-bit of the I-register is set to 1; otherwise, it is set to 0. Ifthe 
value of the second operand is zero, the contents of $R1 are used as a mask. Upon 
completion of the instruction, each bit of the first operand which was checked is set to the 
one’s complement of is original value. 
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LBF 


LBF | | | fo " 
Instruction: ew! 
Load bit and set false 

Type: 

SO 


Source Language Format: 


internal-value-expression 
ALBFAaddress-expression |, 4 external-value-expression 
single-precision-fixed-point-constant 
Description: 
1. Ifthe first operand specifies indexing, the index register is aligned to count bits relative to 
bit 0 of the specified word. The bit thus addressed is loaded into the B-bit of the I-register. 


Upon completion of the operation, the addressed bit is set to 0. The secon operand must 
be omitted when the first operand specifies indexing. 


2. If the first operand does not specify indexing, the value (mask) in the seceiia operand 
identifies which bit(s) are to be checked (e.g., Z°8000’ indicates that the first bit of the word 
found at the specified location of R-register is to be checked); then, if (any of) the specified 
bit(s) contains a binary 1, the B-bit of the I-register is set to 1; otherwise, it is set to 0. Ifthe 
value of the second operand is zero, the contents of $R1 are used as a mask. Upon 
completion of the instruction, each bit of the first operand which was checked is set to 0. 


This instruction operates in read modify write (RMW) mode, which prevents any other processor 
in a multiprocessor environment from accessing the location being modified until the modifica- 
tion is completed. 

The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Bn| register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 
Immediate operand addressing 
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LBS 


( : LBS 


Instruction: 


Load bit and swap 


Type: 
SO 


Source Language Format: 


internal-value-expression 
ALBSAaddress-expression |}, { external-value-expression 
single-precision-fixed-point-constant 


Description: 


1. Ifthe first operand specifies indexing, the index register is aligned to count bits relative to 
bit 0 of the specified word. The bit thus addressed is interchanged with the B-bit of the 
I-register. The second operand must be omitted when the first operand specifies indexing. 


2. If the first operand does not specify indexing, the value (mask) in the second operand 
identifies which bit(s) are to be checked (e.g., Z°8000’ indicates that the first bit of the word 
found at the specified location of R-register is to be checked); then, if (any of) the specified 
bit(s) contains a binary 1, the B-bit of the I-register is set to 1; otherwise, it is set to 0. Ifthe 
value of the second operand is zero, the contents of $R1 are used as a mask. Upon 
completion of the instruction, each bit of the first operand that was checked is set equal to 
the original value of the B-bit of the I-register. 


The address expression can take any of the forms described earlier in this section under 
7 “Addressing Techniques,” except for the following: 
( =$Bn| register addressing 
=$Sn 
Short displacement addressing 
Specialized addressing 
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LBT 


Instruction: 
Load bit and set true 


Type: 


SO 


Source Language Format: 


internal-value-expression 


ALBTAaddress-expression |, {external-value-expression 
single-precision-fixed-point-constant 
Description: 
1. Ifthe first operand specifies indexing, the index register is aligned to count bits relative to 


bit 0 of the specified word. The bit thus addressed is loaded into the B-bit of the I-register. 


Upon completion of the operation, the addressed bit is set to 1. The second operand must 
be omitted when the first operand specifies indexing. 


If the first operand does not specify indexing, the value (mask) in the second operand 
identifies which bit(s) are to be checked (e.g., Z'8000’ indicates that the first bit of the word 
found at the specified location of R-register is to be checked); then, if (any of) the specified 
bit(s) contains a binary 1, the B-bit of the I-register is set to 1; otherwise, it is set to 0. 
If the value of the second operand is zero, the contents of $R1 are used as a mask. Upon 
completion of the operation, the bit(s) checked in accordance with the mask is (are) set to 
ds 


Upon completion of the operation, the bit(s) checked in accordance with the mask is (are) 
set to 1. 


This instruction operates in read modify write (RMW) mode, which prevents any other processor 
in a multiprocessor environment from accessing the location being modified until the 
modification is completed. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Bn| register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 
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LDB 


LDB 
Instruction: 
Load B-register 
Type: 
DO 
Source Language Format: 
ey 
ALDBA X‘n’ } ,address-expression 
n 
Description: 


Loads the contents of the location or B-register specified by the address expression into the 
B-register identified in the first operand. | 
The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Rn | register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 


Immediate operand addressing with a value expression. 
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LDH 


LDH -_ 
Instruction: aka 
Load half-word (byte) into R-register 
Type: 
DO 
Source Language Format: 
$Rn 
ALDHA , X‘n’? ,address-expression 
n 
Description: 


Loads the contents of the location specified in the address expression, as described below, into 
the R-register identified in the first operand: 


e If the address expression specifies =$Rn, the rightmost byte (sign extended) of that 
R-register is loaded into the R-register specified by the first operand. 


e Ifthe address expression specifies Memory Addressing without indexing, or an Immediate 
- Operand Addressing format, the leftmost byte (sign extended) of the word found at the 
specified location is loaded into the R-register. 


e Ifthe address expression specifies Memory Addressing with indexing, the index register is 
aligned to count bytes relative to the leftmost byte of the word specified. The byte thus 
addressed is loaded (sign extended) into the R-register. 

In all cases, the selected byte is loaded into the rightmost byte of the R-register, with the sign 
extended to the left. 

The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 

=$Bn| register addressing 

=$Sn 

Short displacement addressing 

Specialized addressing 
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LDI 


LDI 

Instruction: 

Load double-word integer 

Type: 

SO 

Source Language Format: 
ALDIAaddress-expression 


Description: 


Loads the contents of the location specified by the address expression into register R6 and the 
contents of the next location into register R7. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 

=$Bn| register addressing | 

=$Sn 

Short displacement addressing 

Specialized addressing 


If the address expression specifies memory addressing with indexing, the index register is 
aligned to count double-words relative to the word specified. 


If Immediate Operand Addressing is specified, the immediate operand may only use a binary 
integer constant (which is sign extended to 32 bits by the Assembler), a double precision 
fixed-point constant, or a string constant of exactly two words (i.e., four bytes or 32 bits). 


If =$Rn is used, only = $R3 (loads the contents of R2 and R3 into R6 and R7, respectively) or 
=$R5 (loads the contents of R4 and Rd into R6 and R7, respectively) and =$R7 may be used. 
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LDR 


LDR 

Instruction: 

Load R-register 

Type: 

DO 

Source Language Format: 
$Rn 

ALDRA , X‘n’? ,address-expression 

n 

Description: 


Loads the contents of the location or R-register identified in the address expression into the 
R-register identified in the first operand. 
The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 

=$Bn | register addressing 

=$Sn 

Short displacement addressing 

Specialized addressing 
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LDT 


LDT 

Instruction: 

Load stack address register 
Type: 

GE 

Source Language Format: 


$Bn 
ALDTA ¢ X‘n’ 


n 


Description: | 


Loads the T register with the address contained in $Bn. 


Stack instructions are double-word instructions with the following characteristics: 
e A common first word. 
e Bits 0 through 8 and bit 12 of the second word contain zeros. 


If bits 0 through 8 and bit 12 of the second word are not zero, the result is a trap to trap vector 16. 
Register $Bn is specified in bits 13 through 15 of the second word of the LDT instruction. 


Stack instructions can be executed only on model 6/40 and 6/50 systems. 
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LDV 


LDV 
Instruction: | 
Load value 
Type: 
SI 
Source Language Format: 
[ee] tae 
ALDVA } X‘n’? , [=]internal-value-expression 
n 
Description: 


Loads the 8-bit value identified in the second operand into the right half-word of the R-register 
specified in the first operand. The contents of bit 8 are extended through the left half-word of the 
R-register. 


Except for the string constant form of the second operand, all values are assumed to be numeric. 
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LEV 


LEV 

Instruction: 

Level Change 

Type: 

SO 

Source Language Format: 


ALEVAaddress-expression 


Description: 


Sets or resets level activity bits according to the contents of the location indicated by the address 
expression. 


The following bit configurations in the indicated location produce the actions described below. 


Bit: oO 1 2 3 4 5 67 8 § 10 15 


Schedule Interrupt Level, Scan and Dispatch 


The level activity bit for the designated level will be set. The level activity bits will be scanned 
and the highest active level ascertained. The context of the current level will be saved (unless 
the current level is the highest active level). The context of the highest active level will be 
restored (again, unless the current level is the highest active level). 


Blte .O) We. 2 a SO. FB Oe TO 15 


Schedule Interrupt Level, Defer Interrupt 
The level activity bit for the designated level will be set. Execution will continue at the current 
level. 


Bit: 0 e 3 4 5 6 7 8 9 10 17 12 13 14 «+15 
0 | Q, 7 


| 


Inhibit 
_ The level activity bit for priority level 3 will be set. The interrupt vector for priority level 3 will 


be set equal to the interrupt vector for the current level. Execution of the current task continues 
at priority level 3. The use of level 3 as the inhibit level is a software convention. 


Bits 0 a 3 2 © 36 Fe OTD 15 
i Cy eee be 


| 


Schedule Interrupt Level. Suspend, Scan and Dispatch 


The level activity bit for the designated level will be set. The level activity bit for the current 
level will be reset. The level activity bits will be scanned and the highest level ascertained. The 
context of the current level will be saved. The context of the highest active level will be restored. 
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LEV 


Bit: Oo @ 3 &  & 6 7 68.9 10-11 12 13 14 15 


Suspend, Inhibit | 
The level activity bit for the current level will be reset. The level activity bit for priority level 3 
_ will be set. The interrupt vector for priority level 3 will be set equal to the interrupt vector for the 
current level. Execution of the task continues at priority level 3. The use of level 3 as the inhibit 
level is a software convention. | 


Bits 0 2 3. 4. OB: 6 7 BO 01 12. 13 14 2 15 


Enable 


Enable is used to end execution at priority level 3. The level activity bit for priority level 63 will 
be set. The level activity bit for priority level 3 will be reset. The level activity bits will be 
scanned and the highest active level ascertained. The context of the current level is saved 
(unless the level where the inhibit originated is now the highest active level). The context of the 
highest active level will be restored (again, unless the level where the inhibit originated is now 
the highest active level). 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


| register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 


The P-bit in. the S-register must be set to 1 or the ring field in the S-register must be 1x, as 
appropriate, (i.e., the central processor must be in the privileged state) for this instruction to be 
executed. The unprivileged use of a privileged operation is signified by a trap to trap vector 13. 
(Traps and trap handling are described in the System Service Macro Calls manual.) 


The contents of the S-register are affected as follows: 


e Bits 10 through 15 of the S-register will be set to indicate the priority level at which 
processing continues after execution of the LEV instruction. 
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LLH 

Instruction: 

Load logical half-word (byte) into R-register 
Type: 

DO 

Source Language Format: 


$Rn 
ALLHA { X‘n’ } ,address-expression 


n 


Description: 


LLH 


Loads the contents of the location specified in the address expression, as described below, into 
the R-register identified in the first operand. 


e Ifthe address expression specifies =$Rn, the rightmost byte of that R-register is loaded 


into the R-register specified by the first operand. 


e Ifthe address expression specifies Memory Addressing without indexing, or an Immediate 
Operand Addressing format, the leftmost byte of the word found at the specified location is 


loaded into the R-register. 


e Ifthe address expression specifies Memory Addressing with indexing, the index register is 
aligned to count bytes relative to the leftmost byte of the word specified. The byte thus 
addressed is loaded into the R-register. 


In all cases, the selected byte is loaded into the rightmost byte of the R-register, with 0’s loaded 


into the leftmost byte. 


The address expression can take any of the forms described earlier in this section under 


“Addressing Techniques,” except for the following: 


=$Bn | register addressing 
=$5S 

Short displacement addressing 
Specialized addressing 
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LNJ 


LNJ 

Instruction: 

Load B-register and jump 
Type: 

DO 


Source Language Format: 


$Bn) P-relative-address 
ALNJA 4 X‘n’ immediate-memory-address 
i“ ’ | B-relative-address 


interrupt-vector-addressing 
Description: 


Loads the address of the next sequential instruction into the B-register identified in the first 
operand, and jumps to the location specified in the second operand. 


If the J-bit in the M1-register contains a binary.1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the second operand is executed. The last instruction in the subroutine 
should be: | : 


_JMP $Bn 
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LRDB 


LRDB 

Instruction: 

Load Remote Descriptor Base Register 
Type: 

GE 


Source Language Format: 
ALRDB 


Description: 


Loads the contents of register B3 into the Remote Descriptor Base Register. 


This instruction is executable only on 6/40 and 6/50 models. 
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MCL 

Instruction: 

Call monitor via trap 
Type: 

GE 

Source Language Format: 


AMCL 


Description: 


Calls monitor by a trap to trap vector 1. 
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MLV 


MLV 
Instruction: 
Multiply by value 
Type: 
SI 
Source Language Format: 
til 
AMLVA j X‘n’; , [=]internal-value-expression 
n 
Description: 


Multiplies the contents of the R-register identified in the first operand by the 8-bit value (with 
sign extended) specified in the second operand. The result is saved in the first operand 
R-register. 


If R7 is identified as the first operand R-register, the result (double-precision format) is saved in 
R6 and R7, with the most significant part in R6 and the least significant in R7. 
The contents of the I-register are affected as follows: 


e Iftheresultis more than 2” —1 (32767) or less than — 2°(— 32768) (except if R7 is specified), 
the OV-bit is set to 1 and the operation is not performed (the first operand R-register is 
unchanged); otherwise, it is set to 0. 
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MMM 


MMM 


- Instruction: 


Memory to Memory Move 


Type: 

GE 

Source Language Format: 
AMMM | 


Description: 


The number of bytes of memory specified in $R6 are moved from one location to another. The 
address of the first byte to be moved is identified by $B2 + $R2, where $R2 contains a signed byte 
displacement from $B2. The address of the first byte of the receiving field is identified by $B3 + 
$R3 where $R3 contains a signed byte displacement from $B3. 


If the sending and receiving fields overlap, the operation is only valid if the receiving field’s 
effective address is less than the effective address of the sending field (i.e., a left shift of n bytes is 
permitted, while a right shift of overlapping fields is undefined). 
The values in the registers are subject to the following requirements: 

$R6=0 

—32768<$R2 + $R6<32767 

—32768<$R3 + $R6<32767 


Values in the registers which do not meet the requirements specified above are signified by 
traps. Trap vector 16 signifies that the value in $R6 is less than zero. Trap vector 15 signifies 
that either $R2 + $R6 or $R3 or $R6 is greater than 32767 or less than —32768. The values in the 
registers are not altered. 


MMM is interruptable. 


Successful completion results in the values in registers $B2 and $B3 remaining unchanged, 
while the values in registers $R2 and $R3 have each been incremented by the number of bytes 
specified in $R6, and $R6 equals zero. 


The results of abnormal termination are as follows: 


e The values in registers $B2 and $B3 are unchanged. 


e The values in registers $R2 and $R3 are incremented by the value in $R6 minus the . 


number of bytes not moved. 
e The value in register $R6 equals the number of bytes not moved. 
This instruction is executable only on 6/40 and 6/50 models. 
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MTM 


MTM 
Instruction: 
Modify or test M-register 
Type: 
DO 
Source Language Format: 
AMTMA j X‘n’ ? ,address-expression 
n 
Description: 


Modifies or tests the contents of the M-register identified in the first operand with the contents 
(mask) of the location or R-register specified by the address expression. 


The mask is treated as two 8-bit fields; then, depending on the content of corresponding bits in 
the two fields (i.e., bit 1 in the first field and bit 1 in the second; bit 2 in the first field and bit 2 in 
the second; etc.), the corresponding bit in the M-register (i.e., if bit 1 in the two mask fields, then 
bit 1 in the M-register) is altered as described below: 
e Ifbitnin the first mask field is 1, the corresponding bit in the M-register is loaded with the 
contents of the corresponding bit from the second mask field (i.e., M-register is modified). 
e If bit n in the first mask field is 0 and the same bit in the second mask field is 1, the 
corresponding bit in the M-register is tested. 


e If bit n in the first mask field is 0 and the same bit in the second mask field is 0, the 
corresponding bit in the M-register is neither modified nor tested. 


At completion ofthe instruction, the B-bit in the I-register is set to 1 if (any of) the tested bit(s) is 
set to 1; otherwise (or if no bits were tested) the B-bit in the I-register is set to 0. 


Note: | 
The assembly language instructions LEV, SAVE, and STM store the contents of the 
M-register in a form suitable for reloading by MTM. | 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Bn| register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 
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MUL 


MUL 


we 
Instruction: ; Ni 
Multiply R-register | 
Type: 
DO 
Source Language Format: 
$Rn | 
AMULA { X‘n’ ? ,address-expression 
n 
Description: | 7 
Multiplies the contents of the R-register identified in the first operand by the contents of the 
location or R-register specified in the address expression. The result is saved in the first operand 
R-register. | BOR, 
If R7 is identified as the first operand R-register, the result (double-precision format) is saved in 
R6 and R7, with the most significant part in R6 and the least significant in R7. 
The contents of the I-register are affected as follows: 
e If the product is more than 215 —1 (32767) or less than —215 (—32768) (except if R7 is 

specified), the OV-bit is set to 1; otherwise, it is set to 0. 
The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: | 

se register addressing 

=$Sn 

Short displacement addressing 

Specialized addressing 
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NEG 


NEG 


Instruction: 
Negate 
Type: 
SO 
Source Language Format: 
ANEGAaddress-expression 
Description: 
Twos complements the contents of the location or R-register specified in the address expression. 
The contents of the I-register are affected as follows: 


e Ifacarry occurs during the operation (i.e., the number complemented is zero), the C-bit is 
set to 1; otherwise, it is set to 0. 
e Ifthe value complemented was — 32768, the OV-bit is set to 1; otherwise, it is set to 0. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 

=$Bn | register addressing 

=$Sn 

Short displacement addressing 

Specialized addressing 
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NOP 


NOP 

Instruction: 

No operation 

Type: 

BI 

Source Language Format: 


direct-IMA 
ANOPA { direct-P-relative-address 
short-displacement-address 


Description: 


Performs no operation. 
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OR 


OR 

Instruction: 

Inclusive OR with R-register 
Type: 

DO 


Source Language Format: 
$Rn 
AORA 4 X‘n’ ? ,address-expression 
| n 
Description: 
Performs an inclusive OR operation on the contents of the R-register identified in the first 


operand with the contents of the location or R-register specified in the address expression. The 
result is saved in the first operand R-register. 


The following chart illustrates the result of performing inclusive OR operation on bits: 


First operand bit: 0 bey 
Second operand bit: 1 ] 


[ewe Pb [r 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Bn| register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 
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ORH 
Instruction: 
Half-word (byte) inclusive OR with R-register 
Type: 
DO 
Source Language Format: 
fa 
AORHA X‘n’ / ,address-expression 
n | 
Description: 


An inclusive OR operation is performed on the contents of the R-register identified in the first 
operand with the contents of the byte specified in the address expression. The result is saved in 


the first operand R-register. 


Prior to the operation, the byte operand is internally expanded to word length by extending the 
sign through the eight high-order bit positions. The byte selected to participate in the operation 
is determined by the format of the address expression, as follows: 


e Register Addressing (=$Rn): The rightmost byte of the register is selected. 


e Memory Addressing Without Indexing or Immediate Operand Addressing: The leftmost 
byte of the word at the designated memory address is selected. 
e Memory Addressing With Indexing: The memory address indicates a starting point. The 


index register contains an arithmetic value to be added to the starting point. The value 
specifies the number of bytes before or after the starting point needed to reach the byte 


selected for the operation. 


The following chart illustrates the result of performing an inclusive OR operation on bits: 


The address expression can take any of the forms described earlier in this st under 


“Addressing Techniques,” except for the following: 


7 register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 
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QOH 


QOH 

Instruction: 

Queue on head 

Type: 

GE 

Source Language Format: 
AQOH 

Description: 


This instruction links a new frame into a list before the first frame that has the same priority 
number or the first frame that has a numerically higher priority number. If no frames in the list 
have an equal or higher priority number, the new frame becomes the last frame in the list. 


e Register B1 points to the PRIORITY word of the frame to be added. 
e Register B2 points to the lock word of the list. 


e Register R5 contains the priority to be assigned to the new frame. The PRIORITY word 
will be loaded with the contents of Rd. 


If the instruction is not successfully completed, the carry bit of the indicator register is cleared to 
zero; otherwise it is set to one and the G- and L-bits indicate the position at which the frame is 
linked as shown below. 


Indicator Register Bit Position in List 


G L 
0 0 Before frame with same priority 
1 0 Before frame with higher priority 


number, or as last frame 


Attempts to multiply enqueue a frame will cause unspecified results. 
Queue instructions can be executed only on Model 6/40 and 6/50 systems. 
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QOT 

Instruction: 

Queue on tail 

Type: 

GE 

Source Language Format: 
QOT 

Description: 


This instruction links a new frame into a list after the last frame that has the same priority 
number or before the first frame that has a numerically higher priority number. If no frames in 
the list have an equal or higher priority number, the new frame becomes the last frame in the 
list. 


e Register B1 points to the PRIORITY word of the frame to be added. 
e Register B2 points to the lock word of the list 


e Register R5 contains the priority to be assigned to the new frame. The PRIORITY word 
will be loaded with the contents of R5. 


If the instruction is not successfully completed, the carry bit of the indicator register is cleared to 
zero; otherwise it is set to one and the G- and L-bits indicate the position at which the frame is 
linked as shown below. 


Indicator Register Bit Position in List 


GL 
0 0 After frame with same priority 
0 1 Before frame with higher priority 


number, or as last frame 
Attempts to multiply enqueue a frame will cause unspecified results. 


Queue instructions can be executed only on Model 6/40 and 6/50 systems. 
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a. 


RLQ 


RLQ 


Instruction: 

Relinquish stack space 

Type: 

GE 

Source Language Format: 
ARLQA$Bn 

Description: : 

This stack instruction releases the most recently acquired stack frame. If the stack is emptied by 

this instruction, the result is a trap to trap vector 9. If the stack is not emptied, the current 


length of the stack is adjusted and the base register specified, $Bn (bits 13 through 15 of the 
second word of the instruction), is set to point to the new top frame. 


Stack instructions are double-word instructions with the following characteristics: 
e A common first word. 
e Bits 0 through 8 and bit 12 of the second word contain zeros. 
If bits 0 through 8 and bit 12 of the second word are not zero, the result is a trap to trap vector 16. 


Stack instructions can be executed only on model 6/40 and 6/50 systems. 
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RSTR 


RSTR —_, 
Instruction: aed 
Restore context 

Type: 

SO 


Source Language Format: 


immediate-memory-address 
B-relative-address 
P-relative-address 
interrupt-vector-addressing 


external-value-label 
internal-value-expression 
single-precision-fixed-point-constant 


ARSTRA 


Description: 


Restores the registers specified in the second operand mask starting from the location specified 
in the address expression. 


The second operand is a mask that specifies which registers are to be restored. If the mask is all 
zeros, the contents of Rl are used as the mask. 


Depending on which bits in the specified mask are set to 1, the registers that can be restored are 
11 12 13 «+14 #15 


as follows: 
0 } 2 3 a & §& Ff 8 9 10 


This mask should be the same as the one used to save the registers (see the SAVE instruction). 


Bit: 


ee 
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RTCF 


RTCF 
Instruction: 
Real-time clock off 
Type: 
GE 
Source Language Format: 
ARTCF 
Description: 
Disables real-time clock interrupts. 


The P-bit in the S-register must be set to 1 or the ring field in the S-register must be set to 1x, as 
appropriate (i.e., the central processor must be in the privileged state) for this instruction to be 


executed. If not, the unprivileged use ofa privileged operation is signified by a trap to trap vector 
13. 
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RTCN 


RTCN 
Instruction: 
Real-time clock on 
Type: 
GE 
Source Language Format: 
ARTCN 
Description: 


Enables real-time clock interrupts, which will occur only when the real-time clock interrupt 
level is higher than the priority interrupt level specified in the S-register. 


The P-bit in the S-register must be set to 1 or the ring field in the S-register must be set to 1x, as 
appropriate, (i.e., the central processor must be in the privileged state) for this instruction to be 


executed. If not, the unprivileged use ofa privileged operation is signified by a trap to trap vector 
13. 


For a detailed description of traps and trap handling procedures (i.e., trap handlers), refer to the 
System Service Macro Calls manual. 


For a detailed description of interrupts, refer to theH oneywell Level 6 Minicomputer Handbook. 
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RTT 


RTT 

Instruction: 
Return from trap 
Type: 

GE 


Source Language Format: 
ARTT 


Description: 


Restores the registers that were saved in the trap save area when the trap was entered; restores 
the central processor to the nonprivileged state if entering the trap caused the state to change 
from nonprivileged to privileged; returns the trap save area block to the trap save area memory 
pool; returns control to the next instruction to be executed (determined by the event that caused 
the trap and/or by the trap handler). 
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SAL 

SAL | | , yes. 
Instruction: _— 
Single-shift arithmetic-left 

Type: | 

SHS 


Source Language Format: 


$Rn 
ASALA 4 X‘n’ >? ,internal-value-expression 
n 


Description: 


Shifts the contents of the R-register identified in the first operand left the number of bit 
positions specified in the internal value expression. The bit positions vacated by the shift are 
filled with binary Os. 


The contents of the I-register are affected as follows: 


e Ifthe contents of bit 0in the R-register change at any time during the operation, the OV-bit 
is set to 1; otherwise, it is set to 0. 


The internal value expression must be = 0 and <15 


If the internal value expression equals 0, the contents are shifted left the number derived by 
using the value in bits 12 through 15 of general register R1. 


The following illustrates the operation of the SAL instruction: 


0 Rn 15 | | mos 


Set if Rn(0) changes during the operation. 
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SAR 


SAR 
Instruction: 
Single-Shift arithmetic-right 
Type: 
SHS 
Source Language Format: 
i 
ASARA 4 X‘n’? ,internal-value-expression 
n 
Description: 


Shifts the contents of the R-register identified in the first operand right the number of bit 
positions specified in the internal value expression. The bit positions vacated by the shift are 
filled with the sign value originally contained in bit 0. 


The contents of the I-register are affected as follows: 
e C-bit contains the last binary digit shifted out of the R-register. 
The internal value expression must be = 0 and < 15. 


If the internal value expression equals 0, the contents are shifted right the number derived by. 
using the value in bits 12 through 15 of general register R1. 
The following illustrates the operation of the SAR instruction: 


0. Rn 15 


a 


Saves last bit shifted out of Rn(15). 


ASSEMBLY LANGUAGE INSTRUCTIONS 5-129 | CBO07 


ra 


SAVE 


SAVE 

Instruction: 

Save context 

Type: 

SO 

Source Language Format: 


immediate-memory-address 
ASAVEA B-relative-address 7 
P-relative-address 
( interrupt-vector-addressing 


internal-value-expression 
, 4 external-value-expression 
single-precision-fixed-point-constant 


Description: 


Saves the registers specified in the second operand starting at the location specified in the 
address expression. 


The second operand is a mask that specifies which registers are to be saved. Each bit in the mask 
represents a particular register which can be saved, as shown below: 


Bit: OV. 35 A OS 2 BG VO AF Ve: 13°14 15 


If a mask bit is set to 1, the corresponding register is saved. If a mask bit is 0, the corresponding 
register is not saved. If the mask is 0, the contents of Rl are used as the mask. 


The registers are saved in reverse order. For example, if the second operand specified Z‘CAO1’ 
(which, when translated into binary is 1100 1010 0000 0001), indicating that registers M1, R1, 
R4, R6, and B7 are to be saved, the context save area will contain the registers starting with B7 
and ending with M1. If the 8-bit M1-register is to be saved, the contents are stored in the right 
half word of the location, and the left half-word is filled with 1s. 
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SCL 


SCL 

Instruction: 

Single-shift closed-left 

Type: | 

SHS 

Source Language Format: 

ey 
ASCLA 4 X‘n’? ,internal-value-expression 
n 
Description: 


Shifts the contents of the R-register identified in the first operand left the number of bit 
positions specified in the internal value expression. The bits shifted out of the register are placed 
in the bit positions vacated by shifted bits as they are shifting. | | 


The internal value expression must be > 0 and < 15. 


If the internal value expression equals 0, the contents are shifted left the number derived by 
using the value in bits 12 through 15 of general register R1. 


The following illustrates the operation of the SCL instruction: 
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SCR 


SCR 

- Instruction: 

Single-shift closed-right 
Type: 

SHS 

Source Language Format: 


$Rn 
ASCRA { X‘n’? ,internal-value-expression 
n 
Description: 


Shifts the contents of the R-register identified in the first operand right the number of bit 
positions specified in the internal value expression. The bits shifted out of the register are placed 
in the bit positions vacated by shifted bits as they are shifting. 


The internal value expression must be = 0 and < 15. 


If the internal value expression equals 0, the contents are shifted right the number derived by 
using the value in bits 12 through 15 of general register R1. 


The following illustrates the operation of the SCR instruction: 


as ell 
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SDI 


a SDI | 
( Instruction: 


Store Double word integer 


Type: 
SO 


Source Language Format: 


ASDIAaddress-expression 
Description: 


Stores the contents of register R6 into the location specified by the address expression and the 
contents of register R7 into the next location. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 

=$Bn 

=$Rn?; register addressing 

=$Sn 
If the address expression specifies memory addressing with indexing, the index register is 
aligned to count double-words relative to the word specified. 


If Immediate Operand Addressing is specified, the immediate operand may only use a binary 
integer constant (which is sign extended to 32 bits by the Assembler), a double precision 
fixed-point constant, or a string constant of exactly two words (i.e., four bytes or 32 bits). 


Note: | 
Se, = $R3, =$R5, and =$R7 are permitted and refer to register pairs $R2, $R3; $R4, $R5, 
( and $R6, $R7, respectively. 


Short displacement addressing 
Specialized addressing 
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SID 


SID 


Instruction: 

Subtract integer double 
Type: 

SO 

Source Language Format: 


ASIDAaddress-expression 
Description: 


Subtracts the value of the double-word integer specified by the address expression from the 
value in the register pair $R6, $R7. The result is saved in $R6 and $R7, with the most significant 
part in $R6 and the least significant part in $R7. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 

=$Bn register addressing 

=$Sn | 

Short displacement addressing 

Specialized addressing 


If the address expression specifies memory addressing with indexing, the index register is 
aligned to count double-words relative to the word specified. 


If Immediate Operand Addressing is specified, the immediate operand may only use a binary 
integer constant (which is sign extended to 32 bits by the Assembler), a double precision 
fixed-point constant, or a string constant of exactly two words (i.e., four bytes or 32 bits). 


If =$Rn is used, only =$R3 (subtracts the contents of R2 and R3 from R6 and R7 respectively), or 
$R5 (subtracts the contents of R4 and R5 from R6 and R7 respectively), or =$R7 (clears R6 and 
R7) may be used. 


Ifa borrow is required during the subtraction, the C-bit of the I-register is set to 0; otherwise it is 
set to 1. | 


If overflow occurs, the OV-bit of the I-register is set to 1, otherwise it is set to 0. 
This instruction is executable only on 6/40 and 6/50 models. 
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SOL 


SOL 

Instruction: 
Single-shift open-left 
Type: 

SHS 


Source Language Format: 
$Rn 
ASOLA 4 X‘n’? ,internal-value-expression 
| 
Description: 


Shifts the contents of the R-register identified in the first operand left the number of bit 
positions specified in the internal value expression. The bit positions vacated by the shift are 
filled with binary Os. 


The contents of the I-register are affected as follows: 
e C-bit contains the last binary digit shifted out of the R-register. 
The internal value expression must be = 0 and < 15. 


If the internal value expression equals 0 the contents are shifted right the number derived by 
using the value in bits 12 through 15 of general register, R1. 


The following illustrates the operation of the SOL instruction: 


0 Rn 15 
ee 


Saves last bit shifted out of Rn(0). 
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SOR 


SOR | | —_ 
Instruction: _ a. 
Single-shift open-right 
Type: 
SHS 


Source Language Format: 


$Rn 
ASORA j X‘n’}? ,internal-value-expression 
n 


Description: 


Shifts the contents of the R-register identified in the first operand right the number of bit 
positions specified in the internal value expression. The bit positions vacated by the shift are 
filled with binary Os. 


The contents of the I-register are affected as follows: 
e C-bit contains the last binary digit shifted out of the R-register. 
The internal value expression must be = 0 and < 15. 


If the internal value expression equals 0, the contents are shifted right the number derived by 
using the value in bits 12 through 15 of general register $R1. | 


The following illustrates the operation of the SOR instruction: 


0 Rn 15 
0, > +1 


Saves last bit shifted out of Rn(15). 
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SRDB 
Instruction: 
Store Remote Descriptor Base Register 
Type: 
GE 
Source Language Format: 
ASRDB 
Description: 
Stores the contents of the Remote Descriptor Base Register in register B3. 
This instruction is executable only on 6/40 and 6/50 models. 
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SRM 


SRM — 

Instruction: 

Store register masked 
Type: 

DO 

Source Lancuars Format: 


$Rn 
ASRMA j X‘n’? ,address-expression,mask 
n 


Description: 


Each bit in the mask is individually examined. If the mask bit is 1, the corresponding bit in the 
operand identified by the effective address is changed to the same value as the corresponding bit 
in the R-register. If the mask bit is 0, the value of the bit in the operand identified by the effective 
address is not changed. 


If the mask =0, the contents of $R1 are used in place of the mask. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Bn) register addressing 

=$Sn 

Short displacement addressing 

Specialized addressing 
Example: 


Assume that $R1 contains the value Z‘F300’ and that $R2 contains the value Z’'3DA5’. Also 
assume that the value of bits 4, 6, and 7 of $R1 (i.e., 0, 1 and 1, respectively) are to be put into the 
corresponding bits of $R2, leaving the value of the other bits of $R2 unchanged. Then the 
following SRM would specify this operation: 


SRM $R1,=$R2,Z‘0B00’ 
and the resultant value in $R2 is Z‘37A5’. 
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STB 


STB 

Instruction: 
Store B-register 
Type: 

DO 


Source Language Format: 


$Bn 
ASTBA 4 X‘n’ }? ,address-expression 
n 


Description: 
Stores the contents of the B-register identified in the first operand in the location or B-register 
identified in the address expression. 
The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: | 

_ register addressing 

= $Sn }. 

Short displacement addressing 

Specialized addressing 


‘Immediate operand addressing with a value expression. 
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STH 


STH 
Instruction: 
Store R-register halfword (byte) 
Type: 
DO 
Source Language Format: 
bal 
ASTHA { X‘n’} ,address-expression 
n 
Description: 


Stores the rightmost byte of the R-register identified in the first operand into the location 
specified in the address expression as follows: 


e Ifthe address expression specifies the =$Rn Bggrersine form, the byte is stored in the 
rightmost byte of the specified R-register. 


e If the address expression specifies Memory Addressing without indexing or Immediate 


Operand Addressing, the byte is stored in the leftmost byte of the word found at the 
specified location. 


e Ifthe address expression specifies Memory Addressing with indexing, the index register is 
' aligned to count bytes relative to the leftmost byte of the word specified. The R-register 
byte is stored in the memory byte thus addressed. 


The address expression can take any of the forms described earlier in his section under 
“Addressing Techniques,” except for the following: 


a register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 
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STM 


STM 


Instruction: 
Store M-register 
Type: 

DO 


Source Language Format: 
$Mn 
ASTMA 4 X‘n’ } ,address-expression 
n 
Description: | 
Stores the 8-bit M-register identified in the first operand in the right half-word of the location or 
R-register specified in the address expression; the left half-word of the location is filled with 1s. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Sn 
Short displacement addressing 
Specialized addressing 


a register addressing 


oN 
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STR 

STR 

Instruction: 
Store R-register 
Type: 

DO 


Source Language Format: 
$Rn 
ASTRA ; X‘n’ > ,address-expression | 
n 
Description: 
Stores the contents of the R-register identified in the first operand in the location or R-register 
identified in the address expression. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Bn| register addressing 
=$Sn } 

Short displacement addressing 
Specialized addressing 
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STS 

Instructions: 

Store S-register 

Type: 

SO 

Source Language Format: 


ASTSAaddress-expression 


Description: 

Stores the contents of the system status (s) register in the location or R-register identified in the 
address expression. 

The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Bn| register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 
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STT 


STT 
Instruction: 
Store Stack Address Register 
Type: 
GE 
Source Language Format: 
ASTT 
Description: 
This stack instruction moves the address in the T register to register $B7. 
Stack instructions are double-word instructions with the following characteristics: 
e Acommon first word. _ 
e Bits 0 through 8 and bit 12 of the second word contain zeros. 
If bits 0 through 8 and bit 12 of the second word are not zero, the result is a trap to trap vector 16. 


Stack instructions can be executed only on model 6/40 and 6/50 systems. 
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SUB . 


SUB 

Instruction: 

Subtract from R-register 
Type: 

DO 

Source Language Format: 


$Rn 
ASUBA { X‘n’ > ,address-expression 
n 


Description: 


Subtracts the contents of the location or R-register identified in the address expression from the 
contents of the R-register specified in the first operand. The result is saved in the first operand 
R-register. | 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


on register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 


The contents of the I-register are affected as follows: 


e Ifthe result is more than 2" —1 (32767) or less than — 2 (—32768), the OV-bit is set to 1; 
otherwise, it is set to 0. 


e Ifa borrow is required during the subtraction, the C-bit is set to 0, otherwise it is set to 1. 
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SWB 


SWB 

Instruction: 

Swap B-register 

Type: 

DO 

Source Language Format: 


$Bn 
ASWBA 4 X‘n’/ ,address-expression 
n 


Description: 


Swaps the contents of the B-register identified in the first operand with the contents of the 
location or B-register specified in the address expression. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Rn| register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 


Immediate operand addressing with a value expression. 
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SWR 


SWR 


Instruction: 


Swap R-register 


Type: 
DO 
Source Language Format: 
$Rn 
ASWRA < X‘n’ > ,address-expression 
n 
Description: 


Swaps the contents of the R-register identified in the first operand with the contents of the 
location or R-register specified in the address expression. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


= ot register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 
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VLD 


VLD 

Instruction: 

Validate 

Type: 

GE 

Source Language Format: 
VLD 


Description: 


Determines the access rights to the data whose beginning (virtual) address is contained in $B5 
and whose length, in bytes, is contained in $R3. The access rights are determined with respect to 
the effective ring value contained in bits 1 and 2 of $R5. VLD indicates the Bereeeaouey: of the 
data by storing a value in $R3. 

The possible values to be stored in $R3 after execution of a VLD instruction are as follows: 


$R3 Value Meaning 


J Invalid segment 

0 Read access permitted, write access not permitted 
+2 Read/Write access permitted 
—2 No access permitted 


Figure 5-24 illustrates the VLD instruction operations. 


This instruction is available only with systems that have a Memory Management Unit. 
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qt 


START ADDRESS FROM $B5 


SEPARATE SEG. NO. FROM $B5 


BEGINNING WORD ADDRESS 
RANGE FROM §$R3 
BUFFER ENDING ADDRESS «—~ BEGINNING WORD ADDRESS + RANGE 


RING NO. FROM $R5 


- <> 
| YES 
IS BUFFER 
WITHIN 


SIZE LIMITS 


<r 


Figure 5-24. VLD Instruction Operations 
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WDTF 


WDTF 
Instruction: 
Watchdog timer off 
Type: 
GE | 
Source Language Format: 
AWDTF 
Description: 
Disables the watchdog timer interrupt (i.e., level 1 interrupt). 


The P-bit in the S-register must be set to 1 or the ring field in the S-register must be set to 1x, as 
appropriate, (i.e., the central processor must be in the privileged state) for this instruction to be 


executed. If not, the unprivileged use ofa privileged operation is signified by a trap to trap vector 
13. 
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WDTN 


ace WDTN 

( Instruction: 
Watchdog timer on 
Type: 
GE 
Source Language Format: 

AWDTN 
Description: 
- Enables watchdog timer interrupt (i.e., level 1 interrupt). 


The P-bit in the S-register must be set to 1 or the ring field in the S-register must be set to 1x, as 
appropriate, (i.e., the central processor must be in the privileged state) for this instruction to be 


executed. Ifnot, the unprivileged use of a privileged operation is signified by a trap to trap vector 
13. 
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XOH 


XOH 

Instruction: 

Half-word (byte) exclusive OR with R-register 
Type: 

DO | 

Source Language Format: 


$Rn 
AXOHA ) Xn’? ,address-expression 


n 


Description: 


An exclusive OR operation is performed on the contents of the R-register identified in the first 
operand with the contents of the byte specified in the address expression, and the result is stored 
in the register identified in the first operand. | 


Prior to the operation, the byte operand is internally expanded to word length by extending the 
sign through the eight high-order bit positions. The byte selected to participate in the operation 
is determined by the format of the address expression, as follows: 


e Register Addressing (=$Rn): The rightmost byte of the register is selected. 
e Memory Addressing Without Indexing or Immediate Operand Addressing: The leftmost 
byte of the word at the designated memory address is selected. 


e Memory Addressing With Indexing: The memory address indicates a starting point. The 
index register contains an arithmetic value to be added to the starting point. The value 
specifies the number of bytes before or after the starting point needed to reach the byte 
selected for the operation. 


The following chart illustrates the result of performing an exclusive OR operation on bits: 


First operand bit: 


Second operand bit: 


Result: 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Bn ( register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 
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XOR 


XOR 
Instruction: 
Exclusive OR with R-register | 
Type: 
DO 
Source Language Format: 
$Rn 
AXORA { X‘n’; ,address-expression 
n 
Description: 


An exclusive OR operation is performed on the contents of the R-register identified in the first 
operand with the contents of the location or R-register specified in the address expression. The 
result is saved in the first operand R-register. 


The following chart illustrates the result of performing an exclusive OR operation on bits: 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


ee register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 
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Section 6 


Commercial Instructions 


The commercial instructions are executed by the Commercial Processor, an optional 
hardware item, or by the Commercial Processor simulator, a software item that provides the 
same functionality. | 


The commercial instruction set includes the capabilities for processing bytes, packed decimal 
data and unpacked decimal data. Thus the speed with which business-oriented applications are 
handled is greatly increased. 


BASIC FEATURES 


The basic features of the commercial instruction set are as follows: 


e Decimal Arithmetic 
— Packed decimal and unpacked decimal data types may be intermixed. 
— Decimal arithmetic operands may be 1 through 31 digits in length. 
— Decimal arithmetic instructions are add, subtract, multiply, and divide. 
— All decimal arithmetic instructions provide a hardware rounding option. 


e Data Manipulation Capabilities 
— There are three data modes — ASCII, packed decimal, and unpacked decimal. 


e Data Movement 
— Alphanumeric movement from left or right with character-fill. 
— Numeric move with fill and/or rounding. 
( | — Radix conversion and transliteration instructions. 


e Data Comparison 
— Alphanumeric comparison with fill 
— Numeric comparisons between fields of the same or different format and character type. 
— Scan to determine if one or more strings consisting of one or more characters is 
contained in a source string. 
— Scan to determine of one or more strings consisting of one or more characters is not 
contained in a source string. 


e Editing Capabilities 

— Editing capabilities with micro operations are provided. 

— Micro operations provide alphanumeric and numeric edited move instructions with the 
capability of editing character and numeric strings on a character-by-character or 
digit-by-digit basis, or in a concatenated series of characters and digits. 

— Micro operations are not altered by their execution; therefore, a sequence of micro 
operations can be set to describe a data field and then can be used repeatedly by the edit 
instructions. 

— A single instruction can perform a complicated edit function with great speed. 


The commercial instructions are divided into six categories, as described in the subsequent 
text. The internal formats of the commercial instructions are in Appendix H. 


COMMERCIAL PROCESSOR PROGRAMMING CONSIDERATIONS. 


During the execution of a program that includes two adjacent Commercial Processor instruc- 
tions, the CPU must wait for the first to be completed before initiating the second. However, if a 
Commercial Processor instruction is followed by a CPU or SIP instruction, execution of the CPU 
or SIP instruction begins before the Commercial Processor instruction is completed. Under such 
conditions, the CPU or SIP must not access any of the operands specified by the Commercial 
Processor instruction. The possibility of such a conflict is eliminated by inserting a commercial 
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synchronizing (CSYNC) instruction between the Commercial Processor and the CPU or SIP 
instruction. CSYNC performs no operation except to make the CPU wait for completion of the 
preceding Commercial Processor instruction. 


COMMERCIAL INSTRUCTION CATEGORIES | 
DECIMAL ARITHMETIC INSTRUCTIONS 

These instructions perform the basic arithmetic functions (add, subtract, multiply, and 
divide) on packed and unpacked decimal data, and allow the comparison of decimal data. 


DAD decimal add 
DCM decimal compare 
DDV decimal divide 
DML decimal multiply 
DSM decimal subtract 


RADIX AND MODE CONVERSION INSTRUCTIONS 


These instructions allow 
e Decimal and binary data to be converted from one type to the other. 


e Decimal data of one type to be moved and converted to decimal data of a different type (e.g., 
packed to unpacked). 


CBD convert binary to decimal 

CDB convert decimal to binary 

DMC decimal move and convert 
SHIFT INSTRUCTIONS 


Shift instructions allow decimal data to be shifted a specified number of digits to the right or to 
the left. The sign character, if any, is not affected by the shift operation (i.e., it does not get 
shifted). 


DLS | decimal! left shift 
DRS decimal right shift 
DSH decimal shift 


EDIT INSTRUCTIONS 
These instructions provide for a combined move and edit of decimal or alphanumeric data. 


AME alphanumeric move and edit 
DME decimal move and edit 


CHARACTER STRING INSTRUCTIONS 


These instructions provide for moving, comparing, and translating alphanumeric strings. 


ACM alphanumeric compare 
ALR alphanumeric move left to right 
MAT alphanumeric move and translate 
SRCH _ search 
VRFY verify 

BRANCH INSTRUCTIONS 


The Commercial Processor branch instructions are similar to the CPU branch instructions 
described in Section 5. Execution of the Commercial Processor branch instructions takes place 
mainly in the CPU. The Commercial Processor provides information about the state of the 
indicators. The CPU uses this information to decide whether or not.a branch is required. 


The commercial branch instructions are as follows: 


CBE commercial branch on equal 
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CBG commercial branch on greater 

CBGE commercial branch on greater than or equal 
CBL commercial branch on less than 

CBLE commercial branch on less than or equal 
CBNE commercial branch on not equal 

CBNOV commercial branch on no overflow 

CBNTR commercial branch on no truncation 
CBNSF commercial branch on no sign fault 

CBOV commercial branch on overflow 

CBSF commercial branch on sign fault 

CBTR commercial branch on truncation 

CSNCB commercial synchronize and branch (i.e., B) 
CSYNC commercial synchronize (i.e., NOP) 


COMMERCIAL PROCESSOR INSTRUCTION FORMAT 


The basic format of Commercial Processor instructions, other than branch instructions, are as 
follows: 


Aop codeA data-descriptor [beter | { data-descriptor ‘| 


-int-val-expression int-val-expression int-val-expression 


One, two, or three operands are required depending on the Commercial] Processor instruction. 
All Commercial Processor instructions, except Commercial Processor branch instructions, 
require at least one data descriptor. A data descriptor specifies the type of data on which the 
instruction is to operate and the location of the data. Each data descriptor includes a Commer- 
cial Processor address expression. An internal value expression designates a remote descriptor 
and is used with the remote descriptor base register (RDBR). Address expressions are explained 
later in this section. 


COMMERCIAL PROCESSOR DATA DESCRIPTORS 


Data descriptors can be in line (entered as part of the instruction) or they can be remote 
(placed in a remote descriptor array). If remote descriptors are used, the starting address of the 
remote descriptor array must be loaded into the remote descriptor base register of the CPU. 
(This can be accomplished by use of the CPU instruction LRDB.) The desired remote descriptor 
is referenced by an internal value expression in the Commercial Processor instruction. The 
internal value expression is effectively multiplied by two to obtain the offset of the desired 
remote descriptor from the starting address of the array of descriptors whose starting address is 
contained in the remote descriptor base register (RDBR). (For further information on the use of 
the RDBR, see Appendix H.) The data descriptor names and the type of data they specify are as 
follows: 


Name Data Type 

DESCA Alphanumeric 

DESCP Packed decimal 

DESCU  Unpacked decimal 

DESCB Binary 
ALPHANUMERIC DATA DESCRIPTOR 


An alphanumeric data descriptor describes a field composed of 8-bit (byte) characters, 
normally in ASCII format. | 


Format: 


DESCA (Commercial Processor address expression 


FILL | 
[ byte_offset [ byte_length | | ) 


NO_FILL 
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byte_offset 
An internal value expression having a value equal to 0 to 1, that specifies an 8-bit byte offset 
within the addressed word. 
Default = 0 (See individual instructions for meaning of 0) _ 
byte_length | 
An internal value expression specifying the length of operand in bytes. Valid range is 0 
through 31. 
Default = 0 (See individual instructions for meaning of 0) 


FILL/NO_FILL | 
Specifies whether the FILL option is to be used in case of unequal length fields. 
Default = FILL (shorter field with specified character) 


PACKED-DECIMAL DATA DESCRIPTOR 


A packed decimal data descriptor describes a number whose sign and each digit is internally 
represented by 4 bits. 


Format: 


DESCP (Commercial Processor address expression 


| U[NSIGNED] 
[ digit_offset [ digit_length [, | ) 
T[RAILING] 


digit_offset 
An internal value expression, having a value in the range 0 to 3, that specifies an offset in 
4-bit digits within the addressed word. 
Default = 0. 
digit_length 
An internal value expression that specifies the length of the number in digits. 
Default = 0 (See individual instruction for meaning of 0) 
Valid range is from 0 through 31. 
U[NSIGNED] 
Specifies the number is unsigned. 
TLRAILING] 


Specifies the number has a trailing sign. 
Default = TRAILING 


UNPACKED-DECIMAL DATA DESCRIPTOR 


An unpacked-decimal data descriptor describes a number whose sign and each digit are 
represented by the corresponding 8-bit (byte) ASCII character. 


Format: 


DESCU (Commercial Processor address expression 


r U[NSIGNED] hil 


OIrVARRDT INCHED] 


VLV suivs U 


[ ,byte_offset [ ,byte_length Bo LLEADING] IH 
byte_offset T[RAILING] 
An internal value expression equal to 0 or 1 that specifies on 8-bit (byte) offset within the 


addressed word. 
Default = 0 


byte_length | 
An internal value expression that specifies the length of the number in bytes. a 
Default = 0 : 
Valid range is from 0 through 31. 
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U|NSIGNED | 


Specifies an unsigned number. 
O| VERPUNCHED] 
Specifies a number whose sign is indicated by a trailing overpunch. 


L[EADING | 
Specifies a number whose sign is indicated by the leading byte. 


T[ RAILING | 
Specifies a number whose sign is indicated by the trailing byte. 
Default = OVERPUNCHED 


BINARY DATA DESCRIPTOR 


A binary data descriptor describes a binary integer internally represented by 16 or 32 bits, 
word-aligned, and in two’s complement format. 


Format: 
DESCB (Commercial Processor address expression| ,byte length ]) 
byte_length 
An internal value expression, having a value of 0,2, or 4, that specifies the length of the binary 
integer in bytes. 
Default = 0 (See individual instruction for meaning of 0) 


Note that a binary data descriptor is actually an alphanumeric data descriptor specifying no 
fill and a length, after possible escape to Rn(11-15), of either 2 bytes or 4 bytes. 


ADDRESSING TECHNIQUES FOR COMMERCIAL PROCESSOR INSTRUCTIONS 

A Commercial Processor address expression defines the addressing technique used to refer- 
ence data. It can take any of the following forms: 

e P-relative addressing | 

e B-relative addressing 

e Immediate operand addressing 


e Use of remote descriptor base register (For details, see “Commercial Processor Data 
Descriptors,” above, and Appendix H) 


P-RELATIVE ADDRESSING 


P-relative addressing designates data by indicating the (Assembler-calculated) displacement 
from the current location (i.e., the location of the second word of the data descriptor. P-relative 
addressing references a location directly (with or without indexing) or indirectly as shown by the 
following formats. 

location-expression 
+ Direct P-relative addressing 
temporary-label. 


location-expression 1 
om $R {2} Indexed direct P-relative addressing 
temporary-label 3 


location-expression 
* ae Indirect P-relative addressing 
temporary-label. 
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DIRECT P-RELATIVE ADDRESSING 


This form of addressing allows you to specify a location relative to the P-register (i.e., the 
address of the data descriptor). The following example illustrates this form of addressing. The 
decimal number whose characteristics and address are specified by the first operand is sub- 
tracted from the number whose characteristics and address are specified by the second operand. 
The result is stored at the address specified by the second operand. | 


Example: 
ONEK DC +P‘1024 Packed decimal, 4 digits plus sign 


FOURKDC N‘4096’ Unpacked, unsigned decimal, 4 digits 


DSB DESCP(ONEK.0,5,TRAILING): 
DESCU(FOURK 0,4, UNSIGNED) 


At the completion of the instruction, the unpacked unsigned decimal N‘3072’ is.stored at 
symbolic location FOURK. 


Figure 6-1 illustrates the above example. The following assumptions are made in this figure: 
e Symbolic location ONEK is at location 3000 

e Symbolic location FOURK is at location 3D50 | 

e The decimal subtract (DSB) instruction is assembled at location 1000 


ASSEMBLED INSTRUCTION 
DSB DESCP(ONEK, 0, 5, TRAILING), DESCU(FOURK, 0, 4 UNSIGNED) 


loc 1000 


+ 1FFE words +2D4C words 
loc 3000 loc 3D50 


> |1024 B 000) | 
+P'1024’ | 
33. 30 | 37. 32 
A 


Result = N’3072' 


loc 3000, 1st digit 


effective address | loc 3D50, left byte 
for first operand effective address 
| for second operand 


Figure 6-1. Commercial Processor Direct P-relative Addressing 
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Indexed Direct P-Relative Addressing 


In this type of addressing, the contents of the specified index register, aligned to count digits or 
bytes, are added to the displacement to derive the location of the data to be included in the 


( 3 operation. 
Example: 
Convert binary number — 300 to unpacked decimal with leading sign; and offset by one byte in 
receiving field. Assume that index register R1 contains 4 and index register R2 contains 2. 
BININ DC 0 
DC 0 


DC —300 (FED4 in hexadecimal) 
RESULT RESV 4,‘AA’ (2020202020202020 in hexadecimal) 


CBD DESCB(BININ.$R1,2): 
DESCU(RESULT.$R2,1,4, LEADING) 


Since the sending field is symbolic location BININ+2, which contains —300, and receiving 
field is symbolic location RESULT+1, at completion of the instruction, the RESULT string will 


contain: 
20 20 20 2D 33 30 30 20 
A A A — 8 0 0 A 


Figure 6-2 illustrates the above example. The following assumptions are made in this figure: 
e Symbolic location BININ is at location 3000 

e Symbolic location RESULT is at location 3D50 

e The convert from binary to decimal (CBD) instruction is assembled at location 1000 


( _ ASSEMBLED INSTRUCTION 
: CBD DESCB(BININ,$R1, 2), DESCU(RESULT.$R2, 1, 4, LEADING) 


loc 1000 


loc 3000 Ne loc 3D50 


| 
| 
+ 1FFEwords | | Ay + 2D4C words 
| | 
| 


loc 3000 


effective address 
of first operand 


Result = -L’300’ 
loc 3D50 loc 3D51, right byte 


effective address 
( | of second operand 


Figure 6-2. Commercial Processor Indexed Direct P-relative Addressing 
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Indirect P-Relative Addressing 


In this type of addressing, a location relative to the contents of the P-register contains the 
location of the data to be used by the instruction. In the following example, a binary number is 
converted to an unpacked decimal number. The first data descriptor specifies the binary number 
by referencing the location (BINLOC) that contains its address. The second data descriptor 
references the location (DECLOC) that contains the location (RESULT) of the receiving field. 


Example: 


Convert binary number — 300 to unpacked decimal with leading sign and offset by one byte in 
the receiving field. | 


BINLOC DC <BININ 

DECLOC DC <RESULT 

BININ DC —38:00 (FED4, hexadecimal) 
RESULT RESV 3,‘ | ’ (202020202020, hexadecimal) 


CBD DESCB(BINLOC,2); 
DESCU(** DECLOC,1,4, LEADING) 


At completion of the instruction, the receiving field will contain the following data. 


202D33303020, hexadecimal 
A -—- 800A, decimal 


Figure 6-3 illustrates the above example. The following assumptions are made in this figure: 

e Symbolic location BINLOC is at location 3000 

e Symbolic location DECLOC is at location 3D50 

e Symbolic location BININ is at location CO8F 

e Symbolic location RESULT is at location D317 

e The convert binary to decimal (CBD) instruction is assembled at location 1000 
ASSEMBLED INSTRUCTION 
CBD DESCB(*BINLOC, 2), DESCU(*DECLOC, 1, 4, LEADING) 


loc 1000 


7 0027 0248 1FFE C448 2D4C 
7 


loc 1002 ra 
+ 1FFE words / & 


/ x 
loc 3000 7 
/ 


Indirect 


Faia 


+ 2D4C words 
loc 3D50 


r—— loc CO8F 


offset = 1 byte 
(Te 
| | 20 2D 33 30 30 20 
effective address | 


for first operand | Bes SE SIU 
loc D317, right byte 
effective address 
of second operand 


Figure 6-3. Commercial Processor Indirect P-relative Addressing 
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COMMERCIAL PROCESSOR B-RELATIVE ADDRESSING 


In this form of addressing, a base register (i.e., $B1, ..., $B7) is used to reference a location that 
' contains data or an address. This form of Commercial Processor addressing can be used to 
reference a location directly or indirectly as a disp!acement, or as a displacement with indexing. 


B-relative addressing for Commercial Processor instructions can be represented by any one of 
the following expressions: 
int-val-expression 
$Bn | | Direct B-relative plus displacement 
ext-val-expression 


int-val-expression 
* Bn. 


| Indirect B-relative plus displacement 
ext-val-expression 


int-val-expression | 
$Bn | .Rn Direct B-relative plus displacement with indexing 
ext-val-expression 


int-val-expression | 
* Bn. Rn Indirect B-relative plus displacement with indexing. 


ext-val-expression 


COMMERCIAL PROCESSOR DIRECT B-RELATIVE PLUS DISPLACEMENT ADDRES- 
SING 


This form of addressing causes the system to compute the effective address by adding a specific 
value to the contents of a base register. An example of direct B-relative plus displacement 
addressing in combination with indirect B-relative plus displacement addressing follows the 
explanation of the indirect form of addressing. 


COMMERCIAL PROCESSOR INDIRECT B-RELATIVE PLUS DISPLACEMENT ADDRES- 
SING 


This addressing form effectively adds a displacement value to the contents of the specified 
base register to produce a new address. The contents of this subsequent location are now used as 
the effective memory address. An example of indirect B-relative plus displacement addressing 
in combination with direct B-relative plus displacement addressing is given in the following 
example. 

Example of Commercial Processor Direct and Indirect B-Relative Plus Displacement Addres- 

sing 

ADDR1 DC N‘1234’ Unpacked, unsigned decimal, 4 digits 
ADDR2 DC +P‘2092’ Packed decimal, 4 digit plus sign 

e 

@ 
DSB DESCU($B5.3,0,4,U), DESCP(*$B1.—2,0,5) 

At the completion of the instruction, the packed decimal with trailing sign + P‘858’ is stored at 
symbolic location ADDR2. 


Figure 6-4 illustrates the above example. The following assumptions are made in this figure: 
e Symbolic location ADDR1 is at location 3000 

e Symbolic location ADDR2 is at location 3D50 | 

e The decimal subtract (DSB) instruction is assembled at location 1000 

e $B5.contains 2FFD 
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e $B1 contains 3FE2 


e Location 3FE0 contains a pointer to location 3D50 


ASSEMBLED INSTRUCTION 
DSB DESCU($B5.3, 0, 4, u), DESCP(*$B1.-2, 0, 5) 
) loc 1000 


a 002D 0405 | 0003 | 2589 FFFE i 4 
Pa / 


/ 


in aan ee 
TTT Bey 
k 


loc 2FFD — loc 3000, left byte > | 0358 | Boo |  ¢ 
effective address 
jor air operane loc 3D50, Ist digit Result = +P’858’ 
effective address 
for second operand 


Figure 6-4. Commercial Processor Direct and Indirect 
B-relative Plus Displacement Addressing 


COMMERCIAL PROCESSOR DIRECT B-RELATIVE PLUS DISPLACEMENT WITH IN-— 


DEXING ADDRESSING 


In this form of addressing, the effective address is computed by first determining the 
B-relative plus displacement address; the content of an index register is then added to this result 
to determine the effective address. 


An example of this form of addressing, in combination with indirect B-relative plus displace- 
ment with indexing addressing follows the explanation of the indirect form of addressing. 


~ COMMERCIAL PROCESSOR INDIRECT B-RELATIVE PLUS DISPLACEMENT WITH IN- 
DEXING ADDRESSING 


To determine the effective address, the B-relative plus displacement address is first computed. 
The contents ofthe index register are then added to the contents of the location pointed to by the 
result of the first computation to obtain the effective address. 


Example of Commercial Processor Direct and Indirect B-Relative Plus Displacement With 
indexing Addressing: 
This example is built upon the preceding example, dealing with direct and indirect B-relative 


with displacement addressing. Figure 6-5 illustrates these forms of addressing. The assembled 
instruction for this example is assumed to be: 


DSB DESCU($B5.3.$R2,0,4,U), DESCP(*$B1.—2.$R3,0,5) 


All other assumptions for the preceding example remain unchanged. In addition, $R2 is 
assumed to contain +6 and $R3 is assumed to contain +7. 


Starting with loc 3000 for the first operand in the preceding example, we find the effective 
address with indexing to become loc 3008 (i.e., loc 3000 + 0006 bytes). 
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ff 


For the second operand of the previous example, we find the value 3D50 at the location 3FEO, 
which is the B-relative plus displacement address. The contents of $R3 are added to this value to 
give the effective address for the second operand; i.e., 3D50 + 0007 = 3D57. 


ASSEMBLED INSTRUCTION 
’ DSB DESCU{$B5.3.$r2, 0, 4, u), DESCP(*$B 1.-2.$R3, 0, 5) 
loc 1000 


= 002D 0003 | 2589 | FFFE P{ 


loc 3003, left byte 
effective address 
for first operand 
Result = +P’858’ 


loc 3D51, 4th digit 
effective address for second operand 


Figure 6-5. Commercial Processor Direct and Indirect B-relative Plus 
Displacement with Indexing Addressing 


IMMEDIATE OPERAND (IMO) ADDRESSING 


Immediate operand addressing makes it possible to specify a decimal or string constant as the 
address expression. An IMO operand always occupies one word of memory. If the expressed 
operand is more than one word long, it is truncated on the right to a single word. If the operand is 
less than one word long, it is stored left justified with low order bits zero filled. For numeric 
Commercial Processor instructions, the format of the IMO address expression is: 


= decimal-integer-constant 


For alphanumeric Commercial Processor instructions, the format of the IMO address expression 
1s: 
= string constant 


An IMO address expression must not be specified by the second data descriptor of any Commer- 
cial Processor instruction, except for the compare instructions ACM and DCM. 


An IMO may not be a binary integer constant. 
An IMO address expression must not be specified by any Commercial Processor edit instruction. 
The following example illustrates Commercial Processor IMO addressing. 
Example: 
Assume we wish to convert the packed decimal value of —997 to an unpacked form. 
DMC DESCP(=—P'997’,0,4), DESC U(RESULT, 1,7, LEADING) 
RESULT RESV 5,Z‘2020’ 


The following assumptions are made: 
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e Symbolic location RESULT is at location 9003 | 
e The decimal-move-and-convert (DMC) instruction is assembled at location 7000. 


Figure 6-6 illustrates the above example. 


ASSEMBLED INSTRUCTION: 
DMC DESCP(=—P‘997’, 0, 4), DESCU(RESULT, 1, 7, LEADING) 


loc 7000 


\\ | 0025 24F8 | 997D | C708| 2000 | 


« 


ee address of first operand 
is bit O of location 7002, which contains —P‘997' 


After this instruction is executed, the string named RESULT at 
location 9003 contains —997 in seven digits, in unpacked form, 
with a leading sign and an offset of one 8-bit digit. 


) 202D | 3030 | 3039 | 3937 | 2020 s 
Ne, 


seven digit result 


RESULT ——String of 10 characters 
(loc 9003) 


Figure 6-6. Commercial Processor IMO Addressing 


MICRO EDIT OPERATIONS 


The two move and edit instructions — AME and DME — require micro operations. The 
sequence of micro operations to be executed must be placed in storage before the edit instruction 
is executed. The sequence is referenced by the third data descriptor of the AME or DME 
instruction. Some micro operations insert characters in the string of characters being manipu- 
lated; for example, the currency symbol or the decimal point. Other micro operations replace 
characters in the source string. For example, leading zeros in the source string may be replaced 
with asterisks or blanks in the receiving string. The characters used for replacement or 
insertion are contained in a table called the Edit Insertion Table (EIT) which is described later in 
this section. 


The third data descriptor of a DME or AME instruction points to an array of micro operations. 
Each micro operation is represented by eight bits as shown by the following format. 
0 | 7 bit position within byte 
MOP IF 
0 3 0 3 bit position within field 


MOP — Micro operation code field 
IF — Information field 


The format for specifying a Commercial. Processor micro operation is as follows: 


Commercial Processor-micro-operation(int-val-expression) 
where, Commercial Processor-micro-operation is one of the mnemonics in Table 6-1, and 
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(int-val-expression) must resolve to an integer in the range 0 to 16. Not all integers in 
this range are valid for all micro operations. See description of micro operations for 
restrictions. 


( ao Examples: 
Ste MVZB(4) 
SEF(0) 


Before an edit instruction is executed, you must set up a string by use of the TEXT assembler 
control statement. This string contains the desired micro operations in the sequence in which 
they are performed. For example, the statement 


MOP TEXT SEF(0),MVZA(8) 
sets up a string named MOP that contains the micro operations SEF and MVZA. 


The fourteen micro operations that are available for use with the edit instructions are listed in 
Table 6-1. 
The function of the information field (IF) depends on the micro operation. For example, the IF 
field may specify: 
e The number (1 through 16) of the source digits to be manipulated. (An IF entry of zero 
is used to represent 16 digits.) 
e The character in the Edit Insertion Table to be used. 


e The state in which edit flags are to be placed. 


TABLE 6-1. MICRO OPERATIONS FOR EDIT INSTRUCTIONS 


Code | 
Hexadecimal | Bit Function 


0 CHT Change Edit Insertion Table 
1 ENF End floating suppression 

- 2 IGN Ignore specified source characters 

( 3 INSA Insert asterisk on suppress 

j 4 INSB Insert blank on suppress 
5 INSM . Insert multiple EIT entry 1 characters 
6 INSN Insert on negative 
7 INSP | Insert on positive 
8 MFLC Move with float currency symbol insertion 
9 MFLS Move with float sign insertion 
A unassigned 
B unassigned 
C MVC Move source character 
D MVZA Move with zero suppression and asterisk replacement 
EK MVZB Move with zero suppression and blank replacement 
F SEF Set edit flags 


EDIT INSERTION TABLE 


During the execution of an edit instruction, a hardware table of eight 8-bit characters holds 
insertion information. At the start of each edit instruction, this table is initialized as shown in 
Table 6-2. Any one or all of the table entries can be changed by the Change Table (CHT) micro 


operation. 
TABLE 6-2. EDIT INSERTION TABLE AT INITIALIZATION 
Entry number 
1 2 3 4 5 6 7 8 
Character b = + — $ , . 0 
Hexadecimal code 20 2A 2B 2D 24 2C 2K 30 
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EDIT FLAGS 


Six edit flags are provided for use with the edit micro operations. Some edit flags record 
conditions that occur during execution of the edit instruction. Others allow the user to establish 
conditions for control of the editing. The editing performed by certain micro operations depends 
on the status of specified edit flags. Editing may occur in two stages: (1) while an item is moved to 
the receiving field and (2) at the end of the sequence of micro operations (called post edit). The 
edit flags and their functions are given in Table 6-3. 


TABLE 6-3. EDIT FLAGS FOR MICRO OPERATIONS 


Name Function 


End Suppression(ES) Initial status is OFF. Set on when a non-zero digit from a numeric 
sending field is moved to the receiving field. It can be interrogated and 
its status changed by certain micro operations. 

Sign (SN) Initial status is OFF for alphanumeric sending fields, and for numeric 
sending fields that are positive, or unsigned, or equal to plus or minus 
zero. 

Initial status is ON for numeric sending fields that are negative. 
It can be interrogated by certain micro operations, but, once initialized, 
it cannot be changed by any micro operation. © 

Zero(Z) Initial status is ON. Changed to OFF when a non-zero digit is moved 
from a numeric sending field to the receiving field. Once the Z flag is 
changed to OFF, it remains OFF for the duration of the edit instruction. 
The Z flag can be neither interrogated nor altered by any micro 
operation. 

At post edit, the Z flag is interrogated and the editing then performed 
depends on its status. 

Blank-When-Zero(BZ)? Initial status is OFF. It can be set ON by an ENF or a SEF micro 

operation. Once it is set to ON, it cannot be changed to OFF by any 
micro operation. 
At the end of a micro operation sequence, if both the Z and BZ flags are 
ON, the entire receiving field will be force-filled with the character in 
EIT(1) — normally a space character. Note that this post edit operation 
completely blanks out whatever character string has been moved into. 
the receiving field. 

Asterisk-When-Zero(AZ)?: Initial status is OFF. It can be set ON by the SEF micro operation. Once 

set ON, it cannot be changed to OFF by any micro operation. 
At the end of a micro operation sequence, if the Z flag is ON, the BZ flag 
is OFF, and the AZ flag is ON, the following editing is performed. The 
entire receiving field, except for any characters corresponding to 
EIT(7) — normally a decimal point — will be filled with the character 
specified by EIT(2) — normally an asterisk. 

Plus/Minus(PM) Initial status is OFF. It can be set ON by the SEF micro operation. Once 
set ON it cannot be changed to OFF by any micro operation. The status 
of the PM flag affects the operation of the following micro operations: 
MELS, ENF, INSP, INSN. (See detailed description of micro opcrauous 
later in this section.) 


*The blank-when-zero and the asterisk-when-zero sperations are mutually exclusive. In case of conflict, the blank- 
when-zero operation takes precedence; i.e., the BZ flag is interrogated before the AZ flag. 


CHANGE EDIT INSERTION TABLE (CHT) MICRO OPERATION 


This micro operation changes characters in the Edit Insertion Table as specified by the IF 
entry in the micro operation. If a single character is to be changed, the replacement character is 
specified in the 8-bit byte immediately following the micro operation. If all characters are to be 
changed, the replacement characters are specified in the eight 8-bit bytes immediately 
following the micro operation. To change a given character, specify its entry number as shown 
by Table 6-4. Note that an entry in the range of 9 to F will cause an illegal specification (IS) trap. 
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TABLE 6-4. CODE FOR REPLACING EIT ENTRIES 


IF CODE | OPERATION 


0 Replace all eight EIT entries 
Replace EIT Entry 1 

Replace EIT Entry 2 

Replace EIT Entry 3 

Replace EIT Entry 4 

Replace EIT Entry 5 

Replace EIT Entry 6 

Replace EIT Entry 7 

Replace EIT Entry 8 

9—F Trap 26 Illegal specification 


OnNnoh DHMH 


In the following example, the string of eight characters beginning at the address specified by 
A8 is moved to the receiving field of eight characters beginning at the address specified by 
WKS8K. In the move, leading zeros, are replaced by the pound sign (#). Normally, the zeros 
would be replaced by asterisks but the CHT micro operation has changed the asterisk (EIT entry 
2) to the pound sign. Note that the sending field count and the receiving field count are not 
changed by the CHT micro operation. 


Example: 
MOP TEXT CHT(2),°#’, MVZA(8) 
A8 DC ‘00$81.05’ 


WK8K RESV 4, 


AME _- DESCA(A8,0,8): 
DESCA(WK8K.0,8): 
DESC A(MOP.0,3) 


After the instruction is executed, the contents of the receiving field will be ##$81.05. 


END FLOATING SUPPRESSION (ENF) MICRO OPERATION 


This micro operation terminates zero suppression or floating insertion and forces the 
insertion of the appropriate sign or the appropriate currency symbol, and, optionally, sets the BZ 
flag ON. Only bits 0 and 1 of the IF are used; bits 2 and 3 must be zero. 


0 1 2 3 
es 
The functions performed for valid arguments (IF entries) are as follows. An invalid argument 
will generate trap 26, Illegal Specification. 


Argument IF Function 
0 0000 _—s Insert appropriate sign; do not change BZ 
4 0100 Insert appropriate sign; set BZ ON 
8 1000 Insert appropriate currency symbol; do not change BZ 
12 1100 Insert appropriate currency symbol; set BZ ON 


The sign or currency symbol inserted depends on the status of various edit flags as shown 
below. The entry x under an edit flag column indicates that the flag is not interrogated; i.e., its 
status makes no difference for the specified insertion. The insertion characters shown are those 
normally in the EIT. 


Edit Flag Status 

Insertion 
ES PM SN IFO Character 
ON x x x None 
OFF OFF OFF 0 EIT(1) b 
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OFF x ON 0 EIT(4) —- 
OFF x x 1: EIT(5) $ 
OFF ON OFF 0 EIT(3) + 


At completion of the micro operation, the sending field count is not changed; the receiving 
field count is decremented by one if an insertion occurred, otherwise it is not changed. 


IGNORE SOURCE CHARACTER (IGN) MICRO OPERATION 


This micro operation causes a specified number of bytes in the sending field to be skipped. The 
sending field count is reduced accordingly and no change is made in the receiving field count. 
The number of bytes to be skipped is specified by the IF entry. The Assembler stores zero in the 
IF field to represent 16. 


INSERT ASTERISK ON SUPPRESS (INSA) MICRO OPERATION 


This micro operation causes a character to be inserted in the receiving field. The character 
that is inserted depends on the state of the end suppression (ES) flag and the IF entry in the 
micro operation. If the ES flag is OFF, the IF entry is ignored and the character specified by 
EIT(2) (normally an asterisk) is inserted. Ifthe ES flag is ON, the insertion character is specified 
by the IF entry as follows: | 


IF Entry Character 
1 through 8 EIT(1) through EIT(8) 
0 Character specified in byte that 


follows the micro operation. 
An IF entry of 9 through 15 causes an invalid specification (IS) trap. 


‘At completion, the receiving field count is decremented by one; the sending field count is not 
changed. | 


INSERT BLANK ON SUPPRESS (INSB) MICRO OPERATION 


This micro operation causes a character to be inserted in the receiving field. The character 
that is inserted depends on the state of the end suppression (ES) flag and the IF entry in the 
micro operation. If the ES flag is OFF, the IF entry is ignored and the character specified by 
EIT(1) (Normally a blank) is inserted. If the ES flag is ON, the character is specified by the IF 
entry as follows: 


IF Entry Character 
1 through 8 EIT(1) through EIT(8) 
0 Character specified in byte that 


follows the micro operation. 
An IF entry of 9 through 15 causes an invalid specification (IS) trap. 


At completion, the receiving field count is decremented by one; the sending field count is not 
changed. | 


INSERT MULTIPLE CHARACTERS (INSM) MICRO OPERATION 


This micro operation causes 1 to 16 EIT(1) characters — normally blanks — to be inserted into 
the receiving field. The receiving field count is decremented by the number of characters 


we WI a wWwweweesv 2 wy waa ww eee a 


inserted; the sending field count is not changed. The number of characters inserted corresponds 
to the IF entry. The Assembler stores zero in the IF field to represent 16. 


INSERT CHARACTER ON NEGATIVE (INSN) MICRO OPERATION 


This micro operation causes a character to be inserted into the receiving field. The receiving 
field count is decremented by 1; the sending field count is not changed. The character that is 
inserted depends on the state of the SN flag and the IF entry. Ifthe SN flag is OFF, the IF entry is 
ignored and the character specified by EIT(1) — normally a blank — is inserted. If the SN flag is 
ON, the insertion character is specified by the IF entry as follows: 


fo 
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ane 


api 


IF Entry Character 
1 through 8 EIT(1) through EIT(8) 
0 Character specified in byte that 
follows micro operation. 


An IF entry of 9 through 15 causes an invalid specification (IS) trap. 


At completion, the receiving field count is decremented by one; the sending field count is not 
changed. 


INSERT CHARACTER ON POSITIVE (INSP) MICRO OPERATION 


This micro operation causes a character to be inserted in the receiving field. The receiving 
field count is decremented by 1; the sending field count is not changed. The character that is 
inserted depends on the state of the PM flag, the state of the SN flag, and the IF entry. 

If both the PM and SN flags are OFF, the character is specified by the IF entry. For IF entries 1 
through 8, the character is specified by EIT(1) through EIT(8). For an IF entry of 0, the character 
is specified by the byte that follows the micro operation. The character inserted for other states 
of the flags is shown below. 


PM Flag SN Flag Character 


OFF OFF Specified by IF entry 
OFF ON EIT(1) b 

ON OFF EIT(3) + 

ON ON EIT(4) —- 


MOVE WITH FLOAT CURRENCY SYMBOL INSERTION (MFLC) MICRO OPERATION 


This micro operation floats the appropriate currency symbol over a specified number of 
sending field units as a function of the ES flag. (In this context, a sending field unit is 4 bits for 
packed decimal data; otherwise it is one byte.) The number of sending field units upon which the 
operation is to be performed corresponds to the IF entry. The Assembler stores zero in the IF field 
to represent 16. 

Let the IF entry specify n sending field units. Then when the micro operation is executed, the 
next n units are fetched one at a time and the following actions occur. 

e Ifthe ES flag is OFF and the sending field unit is zero, the character specified by EIT(1) 

(normally a blank) is moved to the receiving field. 

e Ifthe ES flag is OFF and the sending field unit is not zero, the character specified by EIT(5) 
(normally a $) is moved to the receiving field and then the non-zero unit is moved to the 
receiving field, and the ES flag is turned ON. 

e Ifthe ES flag is OFF, and all units in the sending field are zeros, then n EIT(1) characters 
are moved to the receiving field. The ES flag remains OFF. 

e Ifthe ES flag is ON, the next sending field unit is moved to the receiving field. Ifthe ES flag 
is ON at initiation of the micro operation, then n sending field units are moved to the 
receiving field. 

e Ifthe sending field contains at least one leading zero unit and one non-zero unit, then n+1 
units are moved to the receiving field and the ES flag is set ON. 

e Atcompletion of the micro operation, the receiving field count is decremented by either n 
or n+1; the sending field count is decremented by n. 


MOVE WITH FLOAT SIGN INSERTION (MFLS) MICRO OPERATION 


This micro operation floats the appropriate sign character over the specified number of 
sending field units as a function of the ES flag, the SN flag, and the PM flag, and whether the 
sending field unit is zero. (In this context, a sending field unit is 4 bits for packed decimal data; 
otherwise it is one byte.) The number of sending field units upon which the operation is to be 
performed corresponds to the IF entry. The Assembler stores zero in the IF field to represent 16. 
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Let the IF entry specify n sending field units. Then, when the micro operation is executed, the 
next n units are fetched one at a time and the following actions occur. 

e Ifthe ES flag is OFF, a character is moved to the receiving field as specified by Table 6-5. 
An EIT(1) character replaces a zero digit or zero character. An EIT(1) character or a sign 
character is inserted ahead of a nonzero digit or character in the receiving field; the 
nonzero unit is then moved to the receiving field, and the ES flag is set ON. 

e Ifthe ES flag is OFF, and all units in the sending field are zeros, then n EIT(1) characters 
are moved to the receiving field. The ES flag remains OFF. 


e Ifthe ES flagis ON, the next sending field unit is moved to the receiving field. Ifthe ES flag 
is ON at initiation of the micro operation, then n sending field units are moved to the 
receiving field. 

e Ifthe sending field contains at least one leading zero unit oan one non-zero unit, then n+ 1 


units are moved to the receiving field and the ES flag is set ON. 


e Atcompletion of the micro operation, the receiving field count is decremented by either n 
or n+1; the sending field count is decremented by n. 


TABLE 6-5. CHARACTER INSERTION BY MFLS MICRO OPERATION 


ES Flag | PM Flag |SN Flag | Sending Field Unit | Character 


OFF EIT(1) b 
OFF OFF OFF 

OFF 

OFF OFF 


KIT(1) b 
MOVE SOURCE CHARACTER (MVC) MICRO OPERATION 


EIT(4) — 

KIT(3) + 
This micro operation moves the specified number of sending field units to the receiving field. 
(In this context, a unit is 4 bits for packed decimal data; otherwise it is one byte.) The number of 
sending field units upon which the operation is to be performed corresponds to the IF entry. The 
Assembler stores zero in the IF field to represent 16. At completion of the operation, the sending 
field count and the receiving field count are decremented by the specified number of sending 
field units. 


KEK p 
SO S.6 


MOVE WITH ZERO SUPPRESSION AND ASTERISK REPLACEMENT (MVZA) MICRO OPERATION 


This micro operation replaces sending field units that are zeros with asterisks as a function of 
the ES flag. (In this context, a unit is 4 bits for packed decimal data; otherwise it is one byte.) The 
number of sending field units upon which the operation is performed corresponds to the IF entry. 
The Assembler stores zero in the IF field to represent 16. Let the IF entry specify n sending field 
units. Then, when the operation is executed, the next n units are fetched one at a time and the 
following actions occur. 

e Ifthe KS flag is OFF and the sending field unit is zero, the character designated by cs 


(normally an asterisk) is moved to the receiving field. 

e Ifthe ES flag is OFF and the sending field unit is not zero, the sending field unit is moved to 
the receiving field and the ES flag is set ON. 

¢ Ifthe ES flagis ON, the sending field unit is moved to the receiving field. (IF the ES flag is 


wv VLE BAY S an WwW 


on at initiation of the micro operation, n sending field units are moved to the receiving 
field.) 


e Atcompletion of the micro operation, the sending field count and the receiving field count 
are decremented by n. 


MOVE WITH ZERO SUPPRESSION AND BLANK REPLACEMENT (MVZB) MICRO OPERATION 


This micro operation replaces sending field units that are zeros with blanks as a function of 
the ES flag. (In this context, a unit is 4 bits for packed decimal data; otherwise it is one byte.) The 
number of sending field units upon which the operation is performed corresponds to the IF entry. 
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The Assembler stores zero in the IF field to represent 16. Let the IF entry specify n sending field 
units. Then, when the operation is executed, the next n units are fetched one at a time and the 
following actions occur. 7 

e Ifthe ES flag is OFF and the sending field unit is zero, the character designated by EIT(1) 
(normally a blank) is moved to the receiving field. 

e Ifthe ES flag is OFF and the sending field unit is not zero, the sending field unit is moved to 
the receiving field and the ES flag is set ON. 

e Ifthe ES flag is ON, the sending field unit is moved to the receiving field. (If the ES flag is 
on at initiation of the micro operation, n sending field units are moved to the receiving 
field.) 

e Atcompletion of the micro operation, the sending field count and the receiving field count 
are decremented by n. 


SET EDIT FLAGS (SEF) MICRO OPERATION 


This micro operation is used to control four edit flags. The IF field represents a 4-bit binary 
mask. Each bit is associated with an edit flag as shown by the following diagram. 


The ES flag can be set ON or cleared OFF. The other edit flags can be set ON but cannot be 
cleared OFF by this micro operation. The sequence of events that occur during this micro 
operation are summarized below and illustrated in; Figure 6-7. 


o> oat ihe 


Figure 6-7. Flow Diagram of SEF Micro Operation 
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If IF(O) = 1, the ES flag is set ON. 

If IF(O) = 0, the ES flag is cleared OFF. 

If IF(1) = 1, the BZ flag is set ON, and IF(2) is ignored. 

If IF(1) = 0, the BZ flag is not changed and IF(2) is interrogated. 
If IF(2) = 1 and IF(1) = 0, the AZ flag is set ON. 

If IF(2) = 0, the AZ flag is not changed. © 


If IF(3) = 1, the PM flag is set ON. 


If IF(3) = 0, the PM flag is not changed. 


This micro operation has no effect on the sending or receiving field count. 


COMMERCIAL PROCESSOR TRAPS 


The Commercial Processor trap facility monitors the execution of all Commercial Processor 
instructions and sends trap requests to the CPU whenever certain events occur. These traps and 
the events that cause them are shown in Table 6-6. The results of a Commercial Processor trap 
are as follows: 


The trapped Commercial Processor instruction is aborted. 
The operands of the Commercial Processor instruction usually remain unchanged. 


The bit Gif any) of the Commercial Processor indicator that reflects the trap condition is 
changed. 


The bits of the Commercial Processor indicator register used by the trapped instruction are 
left in an unspecified state. 


All other bits of the Commercial Processor indicator remain unchanged. 
The CPU, upon completion of the current CPU instruction, 


—Interrogates the Commercial Processor for the trap vector code. 
—Saves CPU trap context in a trap save area. 
—Branches to the trap handling procedure specified by the trap vector. 


If more than one trap condition exists, the Commercial Processor sends the condition with the 
highest priority to the CPU. The other condition(s) are lost. Trap conditions are usually detected 
in the order listed in Table 6-6. 


Because Commercial Processor instructions are executed in parallel with CPU instructions, 
the following information about the Commercial Processor instruction being executed is stored 
when a trap occurs. 


At initiation of the Commercial Processor instruction: 


—CPU stores the address of the Commercial Processor instruction. 
—Commercial Processor stores the effective address(es) of the operand(s). 


At trap time: 


—CPU stores the trap context of the machine. 

The A-word of the Trap Save Area will contain the address of the Commercial Processor 
instruction that caused the trap. 

The P-word of the Trap Save Area will contain the address of the next sequential 
instruction. 

—A T&V routine’s trap handler (or the trap handler of any other task having exclusive use 
of the Commercial Processor) can obtain the effective address(es) of the data descriptors 
of the trapped instruction by use of a read IOLD instruction directed to the Commercial 
Processor. The format of the trap context is shown in Figure 6-8. The Commercial 
Processor always uses 8 words of context regardless of the range information. The 
number of valid addresses in the trap context depends on the number of data descriptors 
required for the Commercial Processor instruction that trapped. 
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TABLE 6-6. COMMERCIAL PROCESSOR TRAP VECTORS AND EVENTS 


Trap Vector 

Mnemonic . . Commercial Commercial 

and Number Trap Event C/U Indicator Mask 

TV (UR) #23 Reference to | U — 
Unavailable Resource 

TV (BE) #24 NML Bus or Memory U — 
Error 

TV US) #26 Illegal Specification U — 

TV (DZ) #25 Divide by Zero U — 

TV (UC) #27 Illegal Character U — — 

TV (TR) #28 Truncation C CI (TR) CM (TR) 

TV (OV) #29 Overflow C CI (OV) CM (OV) 

TV #30 QLT error U ae 4 


2C = conditional Trap 
U = unconditional Trap 


0 7 8 15 
WORD 1 RFU (CI) 


high order bits 


low order 16 bits 


EA of 3rd data descriptor 


Figure 6-8. lgap Context 


The following descriptions of Commercial Processor traps include a list of the conditions that 
cause each trap. During the execution of some Commercial Processor instructions, traps may be 
generated by conditions that are peculiar to the instruction. Where applicable, such conditions 
are included in the description of the Commercial Processor instruction. 


EA of 1st data descriptor 


EA of 2nd data descriptor 


on DD CO 


TRAP 23 UNAVAILABLE RESOURCE (UR) 


Condition causing trap: 


The Commercial Processor has referenced an unavailable resource. 


TRAP 24 BUS OR MEMORY ERROR (BE) 


Conditions causing trap: 
e The Commercial Processor has detected a bus or memory error. 
e The Commercial Processor has detected a bus command that is out of sequence. 


e The Commercial Processor has detected a Commercial Processor hardware error. 


TRAP 25 DIVIDE BY ZERO (DZ) 


This trap is unconditionally generated whenever the divisor of a decimal divide instruction is 
equal to zero. 
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TRAP 26 ILLEGAL SPECIFICATION (IS) 


Conditions causing trap: 
e An undefined Commercial Processor operation code is detected 
e An operand has a zero length 
e A separate signed operand consists of only a sign 


e The second data descriptor contains an IMO address expression 


TRAP 27 ILLEGAL CHARACTER (IC) 


Conditions causing trap: 
e Anillegal decimal digit is detected (i.e., the low order four bits of a digit is not 0 through 9) 
e An illegal sign digit is detected (i.e., a digit that is not one of the recognized signs) 


e An illegal overpunch is detected. 


TRAP 28 TRUNCATION (TR) 


Conditions causing trap: 


e For this trap to be generated, the TR-bit of the Commercial Processor mode register must 
be set to 1. (The contents of the Commercial Processor mode register can be changed by the 
CPU instruction MTM.) The trap is then generated if the receiving field cannot contain all 


characters of the result. 
If truncation occurs, the TR-bit of the Commercial Processor indicator register is set to 1 
and the leftmost part of the result is stored in the receiving field. 


TRAP 29 OVERFLOW (OV) 
Conditions causing trap: | 
e For this trap to be generated, the OV-bit of the Commercial Processor mode register must 
be set to 1. (The contents of the Commercial Processor mode register can be changed by the 
CPU instruction MTM.) The trap is then generated if the receiving field cannot contain all 
significant digits of the result (leading zeros are not considered significant). 
If a trap occurs, the OV-bit of the Commercial Processor indicator register is set to 1, the 
instruction is aborted, and the original operands are not changed. 
e Ifoverflow occurs but no trap is generated (OV-bit of Commercial Processor mode register 
is 0), the receiving field will not contain the most significant digit(s) of the result. The 
OV-bit of the Commercial Processor indicator register will be set to 1. 


TRAP 30 QUALITY LOGIC TEST (QLT) ERROR (QE) 


Conditions causing trap: 


e Any malfunction detected during a Commercial Processor QLT (mini or maxi) generates 


this trap. 
Normally, the operating system will handle this trap. For further information, refer to the 


Level 6 Minicomputer Handbook. 


EXECUTION DETAILS FOR COMMERCIAL INSTRUCTIONS 
Unless indicated otherwise in the description of the individual instruction, the details given 
below apply to all instructions in the following categories: 


Decimal arithmetic 
Radix and mode conversion 
Shift | 
e Data descriptors may be generated in line as part of the instruction or they may be 
referenced by internal value expressions 
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e If remote descriptor references are generated, the internal value expression specifies the 
offset from the address stored in the remote descriptor base register (in units of double 
words) to the desired descriptor. The value ofthe internal value expression can range from 
0 through 4095. 
e The effective address developed from a descriptor points to the leftmost digit of the 
operand. 


e The Gand L bits of the Commercial Processor indicator register indicate the value of the 
result relative to zero. 


e Ifthe result is shorter than the receiving field, the receiving field will be zero filled to the 
left. 

e Plus (+) and minus (—) zero are allowed on input but are assumed to be plus zero during 
instruction execution. All zero operands generated by the Commercial Processor are plus 
Zeros. 


e The SF-bit of the Commercial Processor indicator register is set to 1 when a ee BEE 
operand is to be stored in an unsigned field. 


e Operands having different sign conventions are allowed. 
e Unpacked decimal zero is represented by 30 eeaceenaan: packed decimal zero is 
represented by 0 (hexadecimal). 


e All signed results will have the hardware generated signs, regardless of the sign 
convention used by the operands at execution time. 


e Zone bits (leftmost four bits of an unpacked decimal number) are ignored on input. The 
zone bit of all results is set to 3 (hexadecimal). 


e Identical overlapping of operands is allowed. If operands overlap in any other way, the 
results are unspecified. 


Unless otherwise indicated, the following details apply to all character string instructions. 


e Data descriptors may be generated in line as part of the instruction or referenced by 
internal value expressions. 


e If remote descriptor references are generated, the internal value expression specifies the 
offset from the address stored in the remote descriptor base register (in units of double 
words) to the desired descriptor. The value ofthe internal value expression can range from 
0 through 4095. 
e Identical overlapping of operands is allowed. If operands overlap in any other way, the 
results are unspecified. 


e Trap 26, illegal specification, is generated if the second operand specifies an IMO. 
(Exception is alphanumeric compare ACM instruction.) 


e Trap 26, illegal specification, is generated if the third operand specifies an IMO. 
e The truncation bit (TR bit) of the Commercial Processor indicator register is set to 1, ifthe 
receiving field cannot accept all characters of the result. 
e Only the leftmost portion of the result will be in the receiving field, if the receiving field 
cannot accept all the characters of the result. 
DETAILED DESCRIPTIONS OF COMMERCIAL INSTRUCTIONS 


The remainder of this section contains detailed descriptions of each commercial instruction. 
The descriptions are arranged in alphabetical sequence by instruction mnemonics. Each 
description includes the name, type, format, and operands, and a functional explanation. 
Commercial Processor data descriptors and Commercial Processor address expressions are 
previously described in this section. Symbolic names, constants, and expressions (other than 
address expressions) are described in Section 2. 


All commercial instructions can be labeled, although labels are not shown in the source 
language formats of the descriptions that follow. 


A summary of the commercial instructions is given in Table H-1 of Appendix H. 


COMMERCIAL INSTRUCTIONS 6-23 CBO07 


ACM 
ACM 


Instruction: 
Alphanumeric compare 
Type: 

Character string 


Source Language Format: 


DESCA (description) DESCA (description) 
AACMA e e b>] fe e e . 
int-val-expression int-val-expression 


Description: 


The character string specified by the first operand is compared with the character string 

specified by the second operand. The comparison proceeds character-by-character from left to 

right. When a mismatch occurs, the binary value of the two unlike characters determine 
_whether the first character string is greater or less than the second, and the G or L bit of the 
Commercial Processor indicator register is set accordingly. 


If the length of the strings are unequal, the shorter string is unconditionally extended to the | 


right with the fill character specified by the second data descriptor. Note that the extension 
takes place internally in the Commercial Processor and not in main memory. 


Ifthe length of both strings are zero, the strings are considered to be equal. 
Both operands may specify IMO’s. 
If the value of the byte length specified by the first data descriptor is zero, the length is contained 


in the right byte of register R4 and can be from 0 through 255 bytes. If the value of the byte’ 


length specified in the first data descriptor is not zero, that value, which can be from 1 through 
31, is the length. 


If the value of the byte length specified by the second data descriptor is zero, register R5 contains 
the fill character (in the left byte) and the length (in the right byte). When escape to register R5 
occurs, the length can be from 1 through 255 characters. If the value of the byte length specified 
in the second data descriptor is not zero, that value is the length and the fill character is an 
ASCII blank (20 hexadecimal). In this case, the length can be from 1 through 31 bytes. 


Applicable Traps 
Trap23 Reference to unavailable resource 
Trap24 Busormemory error 
Trap26 ITllegal Specification 
The contents of the Commercial Processor indicator register are affected as follows: 


e Ifthe value of the first operand string is less than the value of the second operand string, 
the L-bit is set to 1; otherwise, it is set to 0. 


e Ifthe value of the first operand string is greater than the value of the second operand 
string, the G-bit is set to 1; otherwise, it is set to 0. 
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ALR 
ALR 


Instruction: 
Alphanumeric move 
Type: 

Character string 


Source Language Format: 


DESCA (description) DESCA (description 
AALRA 


int-val-expression int-val-expression 


Description: 


The character string is moved from the address specified by the first operand (sending field) to 
the address specified by the second operand. If the length of the receiving field is zero, the TR-bit 
(truncation bit) of the Commercial Processor indicator register is set to 1, and the instruction is 
aborted. Trap 28, truncation, may then be generated as described previously under “Commer- 
cial Processor Traps.” 


If the length of the sending field is zero, the receiving field is filled or not as specified by the 
second data descriptor. 


If the value of the byte length specified by the first data descriptor is zero, the length is contained 
in the right byte of register R4 and can be from 0 through 255 bytes. If the value of the byte 
length specified in the first data descriptor is not zero, that value, which can be from 1 through 
31, is the length. 


If the value of the byte length specified by the second data descriptor is zero, register R5 contains 
the fill character (in the left byte) and the length (in the right byte). When escape to register R5 
occurs, the length can be from 1 through 255 characters. If the value ofthe byte length specified 
in the second data descriptor is not zero, that value is the length, and the fill character is an 
ASCII blank (20 hexadecimal). In this case, the length can be from 1 through 31 bytes. 
Applicable Traps: 

Trap 23 Reference to unavailable resource 

Trap 24 Bus or memory error 

Trap 26 Illegal specification 


Trap 28 Truncation 


The contents of the Commercial Processor indicator register are affected as follows: 


e Ifthe length of the first operand string is greater than the length of the second operand 
string, the TR-bit is set to 1; otherwise, it is set to 0. 
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AME . 
AME 


Instruction: 

Alphanumeric move and edit 
Type: 

Edit 
Source Language Format: 


DESCA(description)| |DESCA(description) DESCA (description) 
AAMEA > ») 
int-val-expression int-val-expression int-val-expression 


Description: 


The character string in the sending field specified by the first data descriptor (DD1) is edited in 
accordance with the micro operations in the field specified by, the third data descriptor (DD3), 
and moved to the receiving field specified by the second data descriptor (DD2). 


The number of edited characters stored in the receiving field can be either more or less than 
those in the sending field. The receiving field may have more characters when micro operations 
specify one or more characters are to be inserted. The receiving field may have less characters 
when a micro operation specifies that one or more characters of the sending field are to be 
skipped. 


The instruction terminates normally when the receiving field is filled. Normal termination 
occurs even though the sending field or the string of micro operations have not been exhausted. 


An illegal specification trap (Trap 26) is generated if either the sending field or the string of 
micro operations are exhausted before the receiving field is filled. 


Execution details are as follows: 


e The effective address developed from a data descriptor points to the leftmost character of 
the operand. | 


e All operations take place from left to right. 


e The valid length of the sending field, the receiving field, and the string of micro operations 
ranges from 1 through 255. Lengths from 32 through 255 are specified via escape to an R 
register. (See Appendix H.) 


e During execution of the instruction, the sending field count indicates the current number 
of characters remaining to be processed. The count is decremented every time a character 
is moved out ‘or skipped over. | 


e During execution of the instruction, the receiving field count indicates the current number 
of positions that remain to be filled. The count is decremented every time a character is 
moved into the receiving field. : 


e The Edit Insertion Table (EIT) is always initialized when the edit instruction is initiated. 
e The edit flags are always initialized when the edit instruction is initiated. 
Applicable Traps: 
Trap 23 Reference to unavailable resource 
Trap 24 Bus or memory error 
Trap 26 Illegal Specification 
Conditions causing trap: 


e The sending field or the string of micro operations is exhausted before the receiving 
field is filled. 


e The length of the sending field, or the receiving field, or the string of micro operations 
is Zero. 
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CBD 
CBD 
Instruction: 
Convert binary to decimal 
Type: 
Radix and mode conversion 


Source Language Format: 


DESCB(description) | DESCP(description) 
ACBDA >, ' DESCU(description) 
int-val-expression | int-val-expression 
Description: 


The binary value specified by the first operand is converted to the decimal data type specified by 
the second operand and stored, right justified, at the address specified by the second operand. 
Execution Details: 


e Ifthe length of the receiving field is greater than the number of significant digits in the 
decimal equivalent of the binary value, the receiving field is zero filled to the left. 


e The high order bit of the binary operand is a sign bit (i.e., the binary value is stored in two’s 
complement notation). 


e Ifthe first data descriptor specifies and IMO, the results are unspecified. 


Applicable Traps: 


During execution of this instruction, Traps 23, 24, 26, and 29 may be generated in the same way 
as during execution of the decimal add instruction DAD. 


Trap 23 Reference to unavailable resource 
Trap 24 Bus or memory error 
Trap 26 Illegal specification 
Trap 29 Overflow 
The contents of the Commercial Processor indicator register are affected as follows: 


e Ifthe number of significant digits in the converted result is greater than the number of 
digit positions available in the receiving field, the OV-bit is set to 1; otherwise, it is set to 0. 


e Ifthe value to be converted is negative and the receiving field is described as unsigned, the 
SF-bit is set to 1; otherwise, it is set to 0. 
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CBE 


“CBE 
Instruction: a 
Commercial Branch if equal a ; 


Source Language Format: 


direct-IMA 
ACBEA direct P-relative 
short displacement address 


Description: | 

Branches to the location specified by the operand if the G-bit and the L-bit of the CIP indicator 
register are both 0. 

Action if Branch Occurs: 


Ifthe J-bit in the M1 register contains a binary 1, the trace procedure is entered via trap vector 2. 
Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 


COMMERCIAL INSTRUCTIONS 6-28 CB07 


CBG 
CBG 


Instruction: 
Commercial Branch if greater 


Source Language Format: 


direct-IMA 
ACBGA j direct P-relative 
short displacement address 


Description: 


Branches to the location specified by the operand if the G-bit of the Commercial Processor 
indicator register is 1. 


Action if Branch Occurs: 


Ifthe J-bit in the M1 register contains a binary 1, the trace procedure is entered via trap vector 2. 
Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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CBGE 
Instruction: op 
Commercial Branch if greater than or equal ew 


Source Language Format: 
direct-IMA 
ACBGEA jdirect P-relative 
short displacement address 
Description: | | 


Branches to the location specified by the operand if the L-bit of the Commercial Processor 
indicator register is 0. | 


Action if Branch Occurs: 


Ifthe J-bit in the M1 register contains a binary 1, the trace procedure is entered via trap vector 2. 
Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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CBL 


Instruction: 
Commercial Branch if less than 


Source Language Format: 


direct-IMA 
ACBLA direct P-relative 
short displacement address 


Description: 


Branches to the location specified by the operand if the L-bit of the Commercial Processor 
indicator register is 1. 


Action if Branch Occurs: 


Ifthe J-bit in the M1 register contains a binary 1, the trace procedure is entered via trap vector 2. 
Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. | 
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CBLE 


Instruction: 


Commercial Branch if less than or equal 


Source Language Format: 


direct-IMA 
ACBLEA {4 direct P-relative 
short displacement address 


Description: 


Branches to the location specified by the operand if the G-bit of the Commercial Processor 
indicator register is 0. 


Action if Branch Occurs: 


Ifthe J-bit in the M1 register contains a binary 1, the trace procedure is entered via trap vector 2. 
Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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CBNE 
CBNE 


Instruction: 


Commercial Branch if not equal 


Source Language Format: 


direct-IMA 
ACBNEA {direct P-relative 
short displacement address 


Description: 

Branches to the location specified by the operand if either (but not both) the G-bit or the L-bit of 
the Commercial Processor indicator register is 1. 

Action if Branch Occurs: 


Ifthe J-bit in the M1 register contains a binary 1, the trace procedure is entered via trap vector 2. 
Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 


COMMERCIAL INSTRUCTIONS 6-33 CBO7 


CBNOV 

CBNOV 

Instruction: 

Commercial Branch if no overflow 


Source Language Format: 


direct-IMA 
ACBNOVA jdirect P-relative _ 
short displacement address 


Description: 


Branches to the location specified by the operand if the OV-bit of the Commercial Processor 
indicator register is 0. 


Action if Branch Occurs: 


If the J-bit in the M1 register contains a binary 1, the trace procedure is entered via trap vector 2. 
Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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CBNSF 
CBNSF 


Instruction: 


Commercial Branch if no sign fault 


Source Language Format: 


direct-IMA 
ACBNSFA jdirect P-relative 
short displacement address 


Description: 


Branches to the location specified by the operand if the SF-bit of the Commercial Processor 
indicator register is 0. 


Action if Branch Occurs: 


Ifthe J-bit in the M1 register contains a binary 1, the trace procedure is entered via trap vector 2. 
Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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CBNTR 

CBNTR 

Instruction: 

Commercial Branch if no truncation 


Source Language Format: 


direct-IMA 
ACBNTRA direct P-relative 
short displacement, address 


Description: 


Branches to the location specified by the operand if the TR-bit of the Commercial Processor 
indicator register is 0. 


Action if Branch Occurs: 


If the J-bit in the M1 register contains a binary 1, the trace procedure is entered via trap vector 2. 
Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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CBOV 


Instruction: 
Commercial Branch on overflow 
Source Language Format: 


direct-IMA 
ACBOVA jdirect P-relative 


short displacement address 


Description: 


Branches to the location specified by the operand if the OV-bit of the Commercial Processor 
indicator register is 1. 


Action if Branch Occurs: 


Ifthe J-bit in the M1 register contains a binary 1, the trace procedure.is entered via trap vector 2. 
Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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CBSF 

CBSF 

Instruction: 

Commercial Branch on sign fault 


Source Language Format: 


direct-IMA 
ACBSFA (direct P-relative 
short displacement address 


Description: 


Branches to the location specified by the operand if the SF-bit of the Commercial Processor 
indicator register is 1. | 


Action if Branch Occurs: 


Ifthe J-bit in the M1 register contains a binary 1, the trace procedure is entered via trap vector 2. 
Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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CBTR 
CBTR 


Instruction: 
Commercial Branch on truncation 


Source Language Format: 


direct-IMA 
ACBTRA jdirect P-relative 
short displacement address 


Description: 


Branches to the location specified by the operand if the TR-bit of the Commercial Processor 
indicator register is 1. 


Action if Branch Occurs: 


Ifthe J-bit in the M1 register contains a binary 1, the trace procedure is entered via trap vector 2. 
Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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CDB 
Instruction: we 
Convert decimal to binary % , 
Type: 


Radix and mode conversion 
Source Language Format: 


DESCP(description) DESCB(description) 
ACDBA DESCU(description) int-val-expression 


int-val-expression 


Description: 
The decimal value specified by the first operand is converted to binary and stored in two’s 
complement notation at the address specified by the second operand. 
Applicable Traps: 
Trap 23 Reference to unavailable resource 
Trap 24 Bus or memory error 
Trap 26 Illegal specification 
Trap 27 Illegal character 
Trap 29 Overflow 
The contents of the Commercial Processor indicator register are affected as follows: 


e Ifthe number of significant bits in the converted result is greater than the number of bit 
positions available in the receiving field (i.e., 15 bits for 2 bytes or 31 bits for 4 bytes), the 
OV-bit is set to 1; otherwise it is set to 0. a 4% 
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CSNCB 
CSNCB 


Instruction: 


Commercial Synchronize and branch 


Source Language Format: 
‘ 


direct-IMA 
ACSNCBA (direct P-relative 
short displacement address 


Description: 


Branches to the location specified by the operand after the previous Commercial Processor 
instruction has been completed. 


Action if Branch Occurs: 


Ifthe J-bit in the M1 register contains a binary 1, the trace procedure is entered via trap vector 2. 
Upon completion, the trace procedure automatically branches to the address specified by the 
operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting at the 
location specified by the operand is executed. 
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CSYNC 

CSYNC 

Instruction: 

Commercial Synchronize 
Type: 

Branch 


Source Language Format: 


direct IMA 
ACSYNCA 4 direct P-relative 
short displacement address [ 


7 


_ Description: 


Prevents the CPU from going to the next instruction until the previous Commercial Processor 
instruction has been completed. Performs no operation. 
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DAD 
Instruction: 
Decimal add 
Type: 
Decimal! arithmetic 


Source Language Format: 


DESC P(description) DESC P(description) 
ADADA 4 DESCU(description) ( , DESC U (description) 
int-val-expression int-val-expression 


Description: 
Adds the decimal value at the address specified by the first operand to the decimal value at the 
address specified by the second operand and stores the result at the address of the second 
operand. 
Applicable Traps: 

Trap 23 Reference to unavailable resource 

Trap 24 Bus or memory error 

Trap 26 Illegal Specification 

Trap 27 Illegal Character 

Trap 29 Overflow 


Whenever Trap 23 or Trap 24 occurs, the preservation of the original operands cannot be 
guaranteed. If any other trap occurs, the operands remain unchanged. 


The contents of the Commercial Processor indicator register are affected as follows: 


e Ifthe number of significant digits in the result is greater than the number of digit positions 
available in the receiving field, the OV-bit is set to 1; otherwise, it is set to 0. 


e Ifthe result is negative and the receiving field is described as unsigned, the SF-bit is set to 
1; otherwise, it is set to 0. 


e Ifthe result is less than zero, the L-bit is set to 1; otherwise, it is set to 0. 


e Ifthe result is greater than zero, the G-bit is set to 1; otherwise, it is set to 0. 
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DCM 


DCM 
Instruction: 


Decimal compare 
Type: 
Decimal arithmetic 


Source Language Format: 
DESC P(description) | DESCP(description) 
ADCMA })DESCU(description) } , , DESCU(description) 
int-val-expression - int-val-expression 
Description: | 
The decimal value specified by the first operand is compared algebraically with the decimal 
value specified by the second operand. 
Execution Details: 


e Ifthe number of digits in the decimal values are not the same, the shorter one is supplied 
with leading zeros. | 


e Plus and minus zero are treated as equal. 

e The data descriptors may specify immediate memory operands (IMO’s). 
Applicable Traps: 

Trap 23 Reference to unavailable resource 

Trap 24 Bus or memory error 

Trap 26 Illegal Specification 

Trap 27 Illegal character 
The contents of the Commercial Processor indicator register are affected as follows: 


e Ifthe value specified by the first operand is less than the value specified by the second 
operand, the L-bit is set to 1; otherwise, it is set to 0. 


e Ifthe value specified by the first operand is greater than the value specified by the second 
operand, the G-bit is set to 1; otherwise, it is set to 0. 
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DDV 


DDV 

Instruction: 
Decimal divide 
Type: 

Decimal arithmetic 


Source Language Format: 


DESCP(description) DESCP (description) DESCP(description) 
ADDVA 4jDESCU(description) 7, { DESCU(description)? , { DESCU(description) 
int-val-expression int-val-expression int-val-expression 


Description: 


Divides the decimal value (the dividend) at the address specified by the second operand by the 
decimal value (the divisor) at the address specified by the first operand. Places the quotient at 
the address specified by the third operand. Places the remainder at the address specified by the 
second operand. If the absolute value of the divisor is greater than that of the dividend, the 
quotient is zero and the dividend and the divisor remain unchanged. 


e Ifthe sign of DD1 is the same as that of DD2, the sign of the quotient is +. 
e Ifthe sign of DD1 is not the same as that of DD2, the sign of the quotient is —. 


e The sign of the remainder is always the same as that of the dividend (DD2) unless the 
remainder is zero. 


Applicable Traps: 
Trap 23 Reference to unavailable resource 
Trap 24 Bus or memory error 
Trap 25 Divide by zero 
Trap 26 [legal specification 
Trap 27 [legal character 
Trap 29 Overflow 
The contents of the Commercial Processor indicator register are affected as follows: 


e Ifthe number of significant digits in the quotient is greater than the number of digit 
positions available in the receiving field, the OV-bit is set to 1; otherwise, it is set to 0. 


e Ifthe quotient is negative and the receiving field is described as unsigned, the SF-bit is set 
to 1; otherwise, it is set to 0. 


e Ifthe quotient is less than zero, the L-bit is set to 1; otherwise, it is set to 0. 


e Ifthe quotient is greater than zero, the G-bit is set to 1; otherwise, it is set to 0. 


COMMERCIAL INSTRUCTIONS 6-45 | CBO7 


DLS 

DLS 

Instruction: 

Decimal left shift 

Type: 

Shift 

Source Language Format: 


DESC P(description) 
ADLSA { DESCU(description)} | ,int-val-expression | 
int-val-expression 
Description: 


_ The decimal value specified by the first operand is shifted left. The vacated digit positions are 
zero filled. The second operand, if present, specifies the distance (number of digits shifted) and it 
must be an integer from 0 through 31. 


When the second operand is present, the assembler: 

e Sets shift control word 1 (SCW1) to 0178 (hexadecimal) 

e Clears bit 0 of SCW2 to 0 (i.e., left shift) 

e Loads the value specified by the second operand in bits 3 through 7 of SCW2 
e Clears bit 8 of SCW2 to 0 (i.e., no rounding) | 


When the second operand is omitted, the assembler generates the shift control words as it does 
for the DSH instruction when the second operand is omitted. The shift direction and the distance 
must then be obtained from register R5. For an explanation of shift control words, see Decimal 
Shift instruction DSH. 


Applicable Traps: 


The traps that may be generated during execution of this instruction are the same as those for 
the DSH instruction. 


Note that only one shift instruction, decimal shift (DSH), is available in the hardware. The 
decimal left shift (DLS) and the decimal right shift (DRS) instruction are provided by the 
Assembler for the programmer’s convenience. 
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DMC 
DMC 


Instruction: 
Decimal move and convert 


Type: 


Radix and mode conversion 


Source Language Format: 


‘ 


DESCP(description) DESC P(description) 
ADMCA 4 DESCU(description) ¢, ,DESCU(description) 
int-val-expression int-val-expression 


Description: 
The decimal value of the data type specified by the first operand is converted to the data type 
specified by the second operand and stored, right justified, at the address specified by the second 
operand. | 
Applicable Traps: 

Trap 23 Reference to unavailable resource 

Trap 24 Bus or memory error 

Trap 26 Illegal specification 

Trap 27 Illegal character 

Trap 29 Overflow 
The contents of the Commercial Processor indicator register are affected as follows: 


e Ifthe number of significant digits in the sending field is greater than the number of digit 
positions available in the receiving field, the OV-bit is set to 1; otherwise, it is set to 0. 


e Ifthe value contained in the sending field is negative and the receiving field is described as 
unsigned, the SF-bit is set to 1; otherwise, it is set to 0. 


e Ifthe value being operated on is less than zero, the L-bit is set to 1; otherwise, it is set to 0. 


e Ifthe value being operated on is greater than zero, the G-bit is set to 1; otherwise, it is set to 
0. 
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DME 

DME 

Instruction: 

Decimal move and edit 
Type: 

Edit 

Source Language Format: 


DESC P(description) 
ADMEA  ; DESCU(description)} , 
int-val-expression 


DESC A(description) DESC A (description) 
int-val-expression |, int-val-expression 


Description: 


The decimal digits in the sending field specified by the first data descriptor (DD1) are edited in 
accordance with the micro operations in the field specified by the third data descriptor (DD3), 
and moved to the receiving field specified by the second data descriptor. If the sending field 
contains packed decimals they are converted to unpacked decimals before they are stored in the 
receiving field. 


The number of edited characters stored in the receiving field can be either more or less than the 
number of digits in the sending field. The receiving field may have more characters when micro 
operations specify one or more characters are to be inserted. The receiving field may have less 
characters when a micro operation specifies that one or more digits are to be skipped. 


The instruction terminates normally when the receiving field is filled. Normal termination 
occurs even though the sending field or the string of micro operations have not been exhausted. 


An illegal specification trap (Trap 26) is generated if either the sending field or the string of 
micro operations are exhausted before the receiving field is filled. 


Execution details are as follows: 


e The effective address developed from a data descriptor points to the leftmost character of 
the operand. 


e All operations take place from left to right. 
e The valid length of the sending field ranges from 1 through 31 digits. 


e The valid length of the receiving field and the string of micro operations ranges from 1 
through 255 characters. Lengths from 32 through 255 can be specified via escape to an R 
register. (See Appendix H.) | 


e During execution of the instruction, the sending field count indicates the current number 
of digits remaining to be processed. The count is decremented every time a digit is moved 
out or skipped over. 


e During execution of the instruction, the receiving field count indicates the current number 
of positions that remain to be filled. The count is decremented every time a character is 
moved into the receiving field. 


e The Edit Insertion Table (EIT) is always initialized when the edit instruction is initiated. 
e The edit flags are always initialized when the edit instruction is initiated. 
Applicable Traps: 
Trap 23 Reference to unavailable resource 
Trap 24 Bus or memory error 
Trap 26 Illegal Specification 
Conditions causing trap: 


e The sending field or the string of micro operations is exhausted before the receiving 
field is filled. 
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DME 


e The length of the sending field, or the receiving field, or the string of micro operations 
is Zero. 


Trap 27 Illegal character 
EXAMPLES OF DME (DECIMAL MOVE AND EDIT) INSTRUCTION 


Example 1: Full Zero Suppression 


Up to six digits are moved with leading zeros suppressed. 


MOP1 TEXT MVZB(6) 
DME DESCP(NUMBER,0,6, UNSIGNED): 
DESC.A(OUTPUT.0,6): 


DESC A(MOP,0,1) 
The results of this instruction for various inputs are as follows: 


NUMBER OUTPUT 
012345 6 12345 
000123 b b 6123 
000000 bb 6 bbb 


Example 2: Partial Zero Suppression 


The last three digits are moved whether they are leading zeros or not. 


MOP2 TEXT MVZA(3),MVC(3) 
DME DESCU(NUMBER,0,6, UNSIGNED); 
DESCA(OUTPUT,0,6); 
DESCA(MOP2,0,2) 


The results of this instruction for various inputs are as follows: 


NUMBER OUTPUT 
012345 * 12345 
000123 SEE IZ 
000000 *** 000 


Example 3: Floating Sign Insertion 


The floating sign (+ or —) is supplied in front of the first nonzero digit. If entire sending field is 
zeros, no sign is supplied. 


MOP3 TEXT SEF(1), MFLS(6),INSM(1) 
DME DESCU(NUMBER,0,7, TRAILING); 
DESCA(OUTPUT.0,7): 
DESCA(MOP3.0,3) 


The results of this instruction for various inputs are as follows: 


NUMBER OUTPUT 
123456+  +123456 
001234- & b-—1234 
000000+ bbHbbKKL 
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DME 


Note that the INSM micro operation is required for an input of all zeros. In this case, no sign is 
supplied and, without the INSM, the micro operation field would be exhausted before the 
receiving field is filled resulting in a trap 26. The INSM is not executed if NUMBER contains a 
nonzero digit. 


Example 4: Negative Sign Only Insertion ; 
The negative sign (—) is supplied if the input is negative; a space is supplied if the input is 
positive. Same as Example 3, except that a space is inserted if the sending field is positive. 


MOP4 TEXT MFLS(6),INSM(1) 


DME ~ DESCU(NUMBER,0,7,LEADING); 
DESCA(OUTPUT,0,7); 
DESCA(MOP4,0,4) 
The results of this instruction for various inputs are as follows: 


NUMBER OUTPUT 
+123456 6123456 
—000123 6B b—123 
+000000 bKBKBBEE 


Example 5: Floating Currency Symbol Insertion 


In this example the sending field NUMBER has two assumed decimal places. The currency 
symbol is forced to the left of the decimal point. The first micro operation applies to the first five 
digits of the data and causes a § to be placed in front of the first nonzero digit. If the first five 
digits are all zero, the ENF(8) micro operation forces the insertion of the $ and turns off further 
suppression. The third micro operation forces the sixth digit to be moved as is, and the last two 
micro operations moves a decimal poirit and two more digits to the receiving field. 


MOP5 TEXT MFLC(5), ENF(8),MVC(1), INSB(7), MVC(2) 
DME DESCU(NUMBER,0,8, UNSIGNED): 
| DESCA(OUTPUT.0,10): 
DESCA(MOP5,5) 


The results of this instruction for various inputs are as follows: 


NUMBER OUTPUT 
12345678  $123456.78 
00012345 6 6 6$123.45 
00000123 6 Bb B$1.23 
00000012 6 Bb BB $0.12 
00000000 6 & BB B $0.00 


Example 6: Separation of Data 


1 1 wite Mn face la fben not 
In this example, the sending field NUMBER consists of eight digits. The four leftmost digits 


represent quantity. The four rightmost digits represent price, which has two assumed decimal 
places. The micro operations specified by MOP6 function as follows: 


MVZB(4) Moves four digits and suppresses leading zeros 

INSB(1) Inserts one space 

INSB(0),‘@’ Inserts at sign 

INSB(1) Inserts one space 

INSB(5) Inserts dollar sign 

SEF(0) Turns ES flag OFF 

MVZA(2) Moves next two digits, replacing leading zeros 
with asterisks 
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INSB(7) Inserts decimal point 


~MVC(2) Moves last two digits 


MOP6 TEXT MVZB(4), INSB(1), INSB(0),°@’ INSB(1), INSB(5); 
SEF(0),MVZA(2), INSB(7),MVC(2) 


DME DESCU(NUMBER.0,8, UNSIGNED): 
DESCA(OUTPUT.0,12): 
DESCA(MOP6,0,10) 


The results of this instruction for various inputs are as follows: 


NUMBER OUTPUT 

00340010 34 @ $**.10 
09900110 990 @ $*1.10 
70810025 7081 @ $**.25 
00505000 50 @ $50.00 
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Instruction: 
Decimal multiply 
Type: 

Numeric 


Source Language Format: 


DESCP(description)) (DESCP(description) ) 
ADMLA +; DESCU(description)? ,{ DESCU (description) 
int-val-expression int-val-expression 


Description: 


Multiplies the decimal value (the multiplier) at the address specified by the first operand by the 
decimal value (the multiplicand) at the address specified by the second operand and stores the 
result (the product) at the address specified by the second operand. 


Applicable Traps: 
Trap 23 Reference to unavailable resource 
Trap 24 Bus or memory error 
Trap 26 Illegal specification 
Trap 27 Illegal character 
Trap 29 Overflow 
The contents of the Commercial Processor indicator register are affected as follows: 


e If the number of significant digits in the product is greater than the number of digit 
positions available in the receiving field, the OV-bit is set to 1; otherwise, it is set to 0. 


e Ifthe product is negative and the receiving field is described as unsigned, the SF-bit is set 
to 1; otherwise, it is set to 0. 


e Ifthe product is less than zero, the L-bit is set to 1; otherwise, it is set to 0. 
e Ifthe product is greater than zero, the G-bit is set to 1; otherwise, it is set to 0. 
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DRS 
Instruction: 


Decimal right shift 

Type: 

Shift 

Source Language Format: 


DESCP (description) | 
ADRSA 4 DESCU (description) | int-val-expression |,R| OUNDED]] | 
int-val-expression 


Description: 


The decimal value specified by the first operand is shifted right. The vacated digit positions are 
zero filled. The second operand, if present, specifies the distance (number of digits shifted) and 
must be an integer from 0 through 31. 


When the second operand is present, the assembler: 
e Sets shift control word 1 (SCW1) to 0178 (hexadecimal). 
Sets bit 0 of SCW2 to 1 (ie., right shift). 
e Loads the value specified by the second operand in bits 3 through 7 of SCW2. 
e Sets bit 8 of SCW2 to 1, if the third operand is present (i.e., rounding). 
e Clears bit 8 of SCW2 to 0, if the third operand is absent (i.e., no rounding). 


When the second and third operands are omitted, the assembler generates the shift control 
words as it does for the DSH instruction when the second operand is omitted. The shift direction, 
the distance, and the rounding control must then be obtained from register R5. For an 
explanation of shift control words, see Decimal Shift instruction DSH. 


Applicable Traps: 


The traps that may be generated during execution of this instruction are the same as those for 
the DSH instruction. 


Note that only one shift instruction, decimal shift (DSH), is available in the hardware. The 
decimal left shift (DLS) and the decimal right shift (DRS) instruction are provided by the 
Assembler for the programmer’s convenience. 
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Instruction: 
Decimal subtract 
Type: 

Decimal arithmetic 


Source Language Format: 


DESCP (description) DESCP(description) 
ADSBA }DESCU(Cdescription); , 4DESCU(description) 7; 
int-val-expression int-val-expression 


Description: 


Subtracts the decimal value (the subtrahend) at the address specified by the first operand from 
the decimal value (the minuend) at the address specified by the second operand and stores the 
result (the difference) at the address specified by the second operand. 


Applicable Traps: 
Trap 23 Reference to unavailable resource 
Trap 24 Bus or memory error 
Trap 26 Illegal specification 
Trap 27 Illegal Character 
Trap 29 Overflow 


The contents of the Commercial Processor indicator register are affected as follows: 


e Ifthe number of significant digits in the difference is greater than the number of digit 
positions available in the receiving field, the OV-bit is set to 1; otherwise, it is set to 0. 


e Ifthe difference is ngative and the receiving field is described as unsigned, the SF-bit is set 
to 1; otherwise, it is set to 0. 


e Ifthe difference is less than zero, the L-bit is set to 1; otherwise, it is set to 0. 
e If the difference is greater than zero, the G-bit is set to 1; otherwise, it is set to 0. 
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DSH 


( Rs Instruction: 
Decimal shift 


Type: 
Shift 


Source Language Format: 


DESC P(description) 
ADSHA }\DESCU(description) { , 


int-val-expression | 
int-val-expression 


ext-val-expression 


Description: 

The decimal value designated by the first operand is shifted the distance (number of digits) and 
in the direction specified by the shift control words. The digit positions that are vacated are zero 
filled. Rounding may be specified for a right shift. If rounding is specified and the value of the 
last digit shifted out is from 5 through 9, the absolute value of the operand is increased by one; 
e.g., +12 becomes +13; —12 becomes —138. | 

The decimal shift instructions use two shift control words SCW1 and SCW2 as shown in 
Figure 6-9. 

The second operand, if present, specifies the value of SCW2, and the assembler generates 0178 
(hexadecimal) as the value of SCW1. The shift control information is taken from SCW2. 

If the second operand is omitted, the Assembler generates 0078 (hexadecimal) and 0000 
(hexadecimal) as the values of SCW1 and SCW2, respectively, and the shift control information 
is taken from register R5. The sign character, if any, is not affected by the shift operation (i.e., it 
does not get shifted). 


0 
op code word | 0 00000000 0 
DD1 or Label 1] 


Shift SCWy 
Control 
Words SOW 


a. With shift control information in line 
0 


op code word;0 00000000 0Q +47 
DD1 or Label 1] 


7 8 Q9 


Shift SCW 
Control 
Words SCWs 


b. With shift control information in CPU register R5 


Figure 6-9. Shift Instruction Formats 
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Note that the formats of SCW2 and R5 are reversed; i.e., the information that is assigned tothe | 
first byte of SCW2 is assigned to the second byte of R5, and that assigned to the second byte of 
SCW2 is assigned to the first byte of R5. When the information comes from R5, the left and right 
bytes must be reversed on the megabus for the Commercial Processor to execute the instruction 
successfully. 


Shift control information is specified by SC W2 or by register R5 as follows. 


e Direction of shift: bit 0 of SC W2; bit 8 of R5 


bit = 0 left shift 
bit = 1 right shift 


e Distance of shift in digits: bits 3 through 7 of SCW2; bits 11 through 15 of R5 
range = 0 through 31 
e Rounding: bit 8 of SCW2; bit 0 of Rd 


bit = 0 do not round 
bit = 1 round after shifting right (ignored for left shift) 


Applicable Traps: 
Trap 23 Reference to unavailable resource 
Trap 24 Bus or memory error 
Trap 26 Illegal specification 


During execution of this instruction, this trap is generated by the conditions previously 
listed under the heading “Commercial Processor Traps.” For this instruction, this trap is 
also generated if the first operand is an IMO. 


Trap 27 Illegal character 


The conditions that generate this rap are the same as those previously listed under the 
heading “Commercial Processor Traps.” However, checks for illegal characters are per- 


formed only upon completion of the shift. Thus, any illegal characters shifted out will not be 
checked. 


Trap 29 Overflow 


The OV-bit of the Commercial Processor indicator register is set to 1, if a non-zero digit is 
shifted out, Trap 29 may then be generated as previously desenbed under the heading 
“Commercial Processor Traps.” 


The contents of the Commercial Processor indicator register are affected as follows: 


e Ifaleft shift specifies a shift distance greater than the number of leading zeros in the value 
to be shifted (i.e., one or more significant digits are lost) or a right shift specifies a shift 
distance greater than the number of trailing zeros in the value to be shifted, the OV-bit is 
set to 1; otherwise, it is set to 0. 


e Ifthe shifted value is less than zero, the L-bit is set to 1; otherwise, it is set to 0. 


e Ifthe shifted value is greater than zero, the G-bit is set to 1; otherwise, it is set to 0. 
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| Instruction: 
( - Alphanumeric move and translate 
Type: 
Character string 


Source Language Format: 


{ DESCA description) | | DESCA (description) 
AMATA | ’ 


: DESCA (description) | 


int-val-expression int-val-expression } |(int-val-expression 


Description: 


The character string in the sending field (specified by the first data descriptor) is translated and 
moved to the receiving field (specified by the second data descriptor). The third data descriptor 
specifies a 256-byte translation table. Each character in the sending field is used as a displace- 
ment from the base of the table and the corresponding character from the table is stored in the 
receiving field. 


Ifthe byte length specified by the first data descriptor is zero, the length is contained in the right 
byte of register R4 and can be from 0 through 255 bytes. If the byte length specified in the first 
data descriptor is not zero, that value, which can be from 1 through 31, is the length. Ifthe length 
of the sending field specified by register R4 is zero, the receiving field is filled or not filled as 
specified by the second data descriptor. Fill characters, if specified, are ASCII blanks and are not 
translated. 


If the byte length specified in the second data descriptor is not zero, that value, which can be from 
1 through 31, is the length. If the byte length specified by the second data descriptor is zero, the 
7 length is contained in register R5 and can be from 0 through 255 bytes. If the length of the 
( receiving field specified by register R5 is zero, the instruction is aborted and the truncation bit 
(TR bit) of the Commercial Processor indicator register is set to 1. Trap 28 (truncation) may then 

be generated as previously described under “Commercial Processor Traps.” 


The length field of the third data descriptor is ignored by the hardware. 
The contents of the Commercial Processor indicator register are affected as follows: 


e Ifthe number of characters in the sending field is greater than the number of character 
positions in the receiving field, the TR-bit is set to 1; otherwise, it is set to 0. 


Example: 
IN DC =Z'00020409’ 
TR DC =‘abcdefg$.!” ’ 
OUT RESV 4, ; 
MAT DESCA(IN,0,4,NO_FILL); 


DESCA(OUT,0,4,NO_FILL); 
DESCA(TR,0,11,NO_FILL) 


After execution of the MAT instruction the receiving field OUT will contain the following 
string: ace! 
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Instruction: 
Alphanumeric search 
Type: 

Character string 


Source Language Format: 


DESCA(description) | DESCA (description) | DESCA (description) 


ASRCHA }. 
int-val-expression int-val-expression int-val-expression 


Description: 


The character string or array of character strings defined by the third data descriptor (DD3) is ° 


searched to see if it contains any of the search arguments (one or more) in the search list defined 
by the first data descriptor (DD1). If a match is found, the G and L bits of the Commercial 
Processor indicator register are cleared to zero, and the displacement and search argument 
number are loaded into the receiving field defined by the second data descriptor (DD2). The 
receiving field must be four bytes long and word aligned, otherwise the results are unspecified. 
The displacement is the distance in bytes between the origin of the string (or array) to be 
searched and the position at which the first match occurs. The search argument number 
designates the one that caused the match. The first argument in the list is identified as 0, the 
second as 1, etc. The format of the receiving field is shown below. 


0 15 0 15 


search argument number displacement 


If a match is not found, the G-bit of the Commercial Processor indicator register is cleared to 
zero, the L-bit is set to one, and the receiving field is not changed. 


The search argument list can contain one or more search arguments each consisting of one or 
more characters. If multiple arguments are specified, each must be the same length. 

If the length field of DD1 is not equal to zero, the search argument list contains only one search 
argument whose length (1 to 31 bytes) is specified by the length field. 


If the length field of DD1 is equal to zero, the search argument list is specified by register R4. The 
format of register R4 is shown below. 


0 7 8 15 


search argument length| search list length 


If the search argument length is equal to the search list length, the search list consists of only 
one argument. 

If the ratio of the search list length to the search argument length is an integer, that integer 
designates the number of search arguments. | 

If the ratio of the search list length to the search argument length is not an integer, the ratio is 


truncated to the integer value and that integer designates the number of search arguments. 


The character string (or array) to be searched is specified by DD3. If the length field of DD3 is not 
equal to zero, the operand is a character string whose length (1 through 31) is specified by the 
length field. If the length field is equal to zero, the operand to be searched is specified by register 
R6. The format of register R6 is shown below. 


0 7 8 | 15 


operand element length operand length 
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If the operand element length is one, the operand is a character string whose length (specified by 
the low order byte of R6) must be from 1 through 255. In this case the search argument length 
must be less than or equal to the operand length, otherwise a not found indication will result. 


If the operand element length is not equal to one, it specifies the length of each element of an 
array. The length of the array is the largest multiple of the operand element length that is less 
_ than or equal to the operand length (specified by the low order byte of R6). In this case, if the 
search argument length is greater than the operand element length, each search will overflow 
into the next entry except when the last operand element is searched. Thus the last comparison 
will result in a mismatch. 
Applicable Traps: 

Trap 23 Reference to unavailable resource 

Trap 24 Bus or memory error 


Trap 26 Illegal character 


Conditions causing trap: 
2» Length of search list is less than length of search argument 
e Length of operand is less than length of operand element 
e Length of search argument is zero 
e Length of operand element is zero 


e The length of one or more of the three operands is zero 


The contents of the Commercial Processor indicator register are affected as follows: 
e The G- and L-bits are set as described above. 
e All other bits are unchanged. 


Examples of Search Instruction: 
The examples given below are divided into four categories as follows: 


e Search String Single (i.e., search a string to determine if it contains the single search 
argument given in the search list) 


e Search String Multiple (.e., search a string to determine if it contains any one of the 
multiple search arguments given in the search list) 


e Search Array Single (i.e., search an array to determine if it contains the single search 
argument given in the search list) 


e Search Array Multiple (i.e., search an array to determine if it contains any one of the 
multiple search arguments given in the search list) 
Example 1: Search String — Single Search Argument 
The search list defined by DD1 contains one search argument of one or more characters. 


If a match is found, the receiving field specified by DD2 is loaded with a zero (the search 
argument number) and the displacement. If a match is not found, DD2 is not changed. 


Assume that DD3 defines the following string. 


Displacement: 0 12 3 4 5 6 7 8 9 A B C 
Strings abc de f g h i j de ik 


The results of a search instruction for this string and various search arguments are as follows. 
Commercial Processor 


SA Indicator Register DD2 Field 

L-Bit G-Bit SA Number Displacement 
d 0 0 («0 3 
fg 0 0 0 5 
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unchanged 


fh 1 0 

dek 0 0 0 A 
1m 1 0 unchanged 

a 0 0 0 0 


Example 2: Search String — Multiple Search Arguments 


The search list defined by DD1 contains multiple search arguments. Each saareh argument can 
consist of one or more characters but all search arguments must be the same length. The search 
argument length (SAL) and the search list length (SLL) is specified by register R4. 


If a match is found, the search argument number and the displacement is loaded into the 
receiving field specified by DD2. If a match is not found, DD2 is not changed. 


Assume that DD3 defines the following string, | 


Displacement: 012 3 4 5 6 7 8 9 A BC 
String: a bcecdefgh ii oj deeéok 


The results of a search instruction for this string and various search arguments are as follows. 
Commercial Processor 


| | Indicator Register DD2 Field 
SAL SLL SA —L-Bit G-Bit SA Number Displacement 
1 8 fej 0 0 1 4 
1 2 r,s 1 0 unchanged " 
2 6 de,hi,er 0 0 0 3 
3 6 «6 cdf, hij 0 0 1 7 
2 4 cb,ka - 1 0 unchanged 


As an example of the sequence of comparisons that occur in seeking a match, consider the third 
search in the above list. This search specifies three search arguments of two characters; namely, 
de,hi,er. The comparisons are as follows: 


ab de 
ab he 
ab er 
be de 
be hi 
be er 
cd de 
cd hi 
cd er 
de de Match of search argument 0 at displacement of 3 


Example 3: Search Array — Single Search Argument | 
The search list defined by DD1 contains one search argument of one or more characters. 


If a match is found, the receiving field specified by DD2 is loaded with a zero (the search 
argument number) and the displacement. If a match is not found, DD2 is not changed. 


Assume that DD3 defines the following array. for which R6 specifies the length or each element 


nn Tr\ nw 9 
(OEL) as 4, and the length of the oper and (OL) as 24. 


Displacement String 


00 abdf 
04 acbe 
08 cade 
0C defg 
10 mjop 
14 eacb 
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The results of a search instruction for this array and various search arguments are as follows. 
Commercial Processor 


Indicator Register 


SA  L-Bit G-Bit 
ca 0 0 
0 0 
mjo 0 0 
mjpo 1 0 
acbec 0 0 
eacba 1 0 
bac 1 0 
cade 0 0 


DD2 Field 
SA Number Displacement 

0 08 

0 00 

0 10 
unchanged | 

0 04 
unchanged 
unchanged 

0 08 


Example 4: Search Array — Multiple Search Arguments 


The search list defined by DD1 contains multiple search arguments. Each search argument can. 
consist of one or more characters but all search arguments must be the same length. The search 
argument length (SAL) and the search list length (SLL) is specified by register R4. 


If a match is found, the search argument number and the displacement are stored in the 
receiving field specified by DD2. If a match is not found, DD2 is not changed. 


Assume that DD3 defines the following array for which register R6 specifies the length of each 
element (OEL) as 4 and the operand length (OL) as 24. 


Displacement String 


00 abdf 
04 acbe 
08 cade 
OC defg 
10 mjop 
14 eacb 


The results of a search instruction for this array and various search arguments are as follows. 


SAL SLL SA 
3 6 acb,acd 
1 3 c,a,d 
4 8 defg,abcd 
2 6 ad,ea,mj 
3 9 aab,abb,eac 
5 10 abdfb,mjope 
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Commercial Processor 


Indicator Register DD2 Field 
L-Bit G-Bit SA Number Displacement 
0 0 0 04 
0 0 1 00 
0 0 0 OC 
0 0 2 10 
0 0 2 14 
0 0 1 10 
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VRFY 
- Instruction 
Alphanumeric verify 
Type: 
Character string 


Source Language Format: 


are ome a | DESCA (description) DESCA (description) 


 AVRFYA : . 
int-val-expression int-val-expression int-val-expression 


Description: 


The character string or array of character strings defined by the third data descriptor (DD3) is 
examined. If at least one character of the string (or element of the array) does not match any one 
of the verify arguments, the G-bit of the Commercial Processor indicator register is cleared to 
zero, the L-bit is set to one, and the receiving field specified by the second data descriptor (DD2) 


is loaded with the displacement. The displacement is the distance in bytes between the origin of 


the string (or array) and the place where the first mismatch is found. The format of the receiving 
field is shown below. 


0 ak 


displacement — 


Tf each of the characters of the string (or elements of the array) is equal to any one of the verify 
arguments, the G- and L-bits of the CIP indicator register are cleared to zero and the receiving 
field is not changed. 


Ifthe length field of DD1 is not equal to zero, the verify argument list contains waly one search 
argument whose length (1 through 31 bytes) is specified by the length field. 


If the length field of DD1 is equal to zero, the verify argument list is specified by register R4. The 
format of register R4 is shown below. 


0 FB 15 


verify argument length verify list length 


If the verify argument length is equal to the verify list length, the verify list consists of only one 
argument. 


If the ratio of the verify list length to the verify argument length is an integer, that integer 


designates the number of verify arguments. 


If the ratio of the verify list nee to the verify argument length is not an epeuee the ratio is 


truncated to the integer value and that integer designates the number of verify arguments. 


The character string (or array) to be verified is specified by DD3. If the length field of DD3 is not 
equal to zero, the operand is a character string whose length (1 through 31) is specified by the 
length field. If the length field is equal to zero, the operand to be searched is specified by register 
R6. The format of register R6 is shown below. 


© 


78 15 


operand element length operand length 
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Ifthe operand element length is one, the operand is a character string whose length (specified by 
the low order byte of R6) must be from 1 through 255. If the operand is a character string, the 
length of the verify argument must be one otherwise the results are unspecified. 


If the operand element length is not equal to one, it specifies the length of each element of an 
array. The length of the array is the largest multiple of the operand element length that is less 
than or equal to the operand length (specified by the low order byte of R6). In this case, if the 
verify argument length is greater than the operand element length, each verify will overflow 
into the next entry except when the last operand is verified. Thus the last comparison will result 
in a mismatch. 

Applicable Traps: 


Trap 23 Reference to unavailable resource 

Trap 24 Bus or memory error 

Trap 26 Illegal Character 

Conditions causing trap: 
e Length of verify list is less than length of verify argument 
e Length of operand is less than length of operand element 
e Length of verify argument is zero 
e Length of operand element is zero 
e The length of one or more of the three operands is zero 
The contents of the Commercial Processor indicator register are affected as follows: 
e The L- and G-bits are set as described above. 
e All other bits are unchanged. 


Examples of Verify Instruction: | 
The examples given below are divided into four categories as follows. 


e Verify String Single (i.e., verify a string to determine if its characters are all equal to the 
single verify argument given in the verify list) 


e Verify String Multiple (i.e., verify a string to determine if its characters are each equal to 
one of the multiple verify arguments given in the verify list) 


e Verify Array Single (i.e., verify an array to determine if its elements are al! equal to the 
single verify argument given in the verify list) 


e Verify Array Multiple (i.e., verify an array to determine if its elements are each equal to 
one of the multiple verify arguments given in the verify list) 
Example 1: Verify String — Single Verify Argument 
The verify list defined by DD1 contains one verify argument consisting of a single character. 


The receiving field specified by DD2 is loaded with the displacement of the first character (in the 
string being verified) that is not the same as that of the verify argument. If all characters are the 
same, the receiving field is not changed. 

Assume that DD3 defines the following strings. The results of verify instructions for the 
specified verify arguments are as follows. 


Displacement: 0123456 


First string: aaabaac 
VA CIP Indicator Register 
L-Bit G-Bit Displacement 
a 1 0 3 
b 1 0 0 
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Displacement: 0123456 
Second string: bbbbbbb 


b 0 0 unchanged 
Example 2: Verify String — Multiple Verify Arguments 


The verify list defined by DD1 contains multiple verify arguments of one character each. The 
verify argument length (VAL) and the verify list length (VLL) is specified by register R4. 


The receiving field specified by DD2 is loaded with the displacement of the first character in the 


string being verified that is not the same as any of the verify arguments. If there is no character 


that is different, the receiving field is not changed. 


Assume that DD3 defines the following string. 
Displacement: 0123456789 
String: abcbbadbcec 


The results of the verify instructions with this string and various verify arguments are as 
follows. 
Commercial Processor 
Indicator Register 


VA L-Bit G-Bit Displacement 

a,b 1 0 2 
a,b,c,e 1 0 6 
a,b,c,d 0 0 unchanged 


Example 3: Verify Array — Single Verify Argument 
The verify list defined by DD1 contains one verify argument consisting of one or more 
characters. | 


The receiving field defined by DD2 is loaded with the displacement of the first element of the 
array that does not contain the verify argument. If all elements of the array contain the verify 
argument, the receiving field is not changed. 


Assume that DD3 defines the following array for which register R6 specifies the length of each 
element as 3 and the length of the operand as 12. . 


Displacement String 


0 aba 
3 abc 
6 abd 
9 ach 


The results of the verify instruction for this array and various search arguments are as follows. 
Commercial Processor: 


Indicator Register 
VA L-Bit G-Bit Displacement 
ab — 1 0 9 
abc 1 0 0 
a O | 9) unchanged 
abaa 1 0 3 


Example 4. Verify Array — Multiple Search Arguments 


The verify list defined by DD1 contains multiple search arguments. Each verify argument can 
consist of one or more characters, but all search arguments for a given instruction must be the 
same length. The verify argument length and the verify list length are specified by register R4. 


The receiving field specified by DD2 is loaded with the displacement of the first element of the 
array that does not contain any of the verify arguments. If all elements of the array contain at 
least one of the verify arguments, the receiving field is not changed. 
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Assume that DD3 defines the following array for which register R6 specifies the length of each 
element as 3 and the length of the operand as 12. 
Displacement String 


0 abcd 
4 acdb 
8 bead 
C acbd 


The results of the verify instruction for this array and various verify arguments are as follows. 


Commercial Processor 
Indicator Register 


VA L-Bit G-Bit Displacement 
ab,ac “1 0 8 
ab,ac,be 0 0 unchanged 
abc,acd,acb 1 0 8 
abcd,acbhd 1 0 4 
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Scientific Instructions 


The scientific instructions are executed by the Scientific Instruction Processor (SIP), an 
optional hardware item, or by the SIP Simulator, a software item that provides the same 
functionality. 


The SIP operates on a powerful set of scientific instructions that are particularly useful for 
FORTRAN applications. The instruction set includes arithmetic operations on single- and 
double-precision floating-point operands, and on single- and double-word integer operands. 


The SIP accepts and processes only one command at a time. However, following the extraction 
of most scientific instructions from memory and the transfer of the instruction to the SIP, the 
CPU can proceed with the extraction of the next instruction while the scientific instruction is 
being executed by the SIP. Note that the execution of scientific instructions may involve the 
reading or writing of main memory. Software that makes use of the SIP should avoid premature 
reading or writing of memory locations specified by an SIP instruction. 


The SIP includes three variable accumulators which may contain floating-point values of two 
or four words. Associated: with each accumulator are control bits that specify the accumulator 
length and the length of the memory operand directed to a given accumulator. (See SIP 
Registers in Section 1.) 


In the SIP, all operands are stored in floating-point format. Operands directed to the SIP from 
main memory are in floating-point format; operands from the CPU are in integer format, but are 
converted to floating-point values before they are entered into scientific calculations. 


SCIENTIFIC TRAPS 


The SIP trap facility monitors the execution of all SIP instructions and sends trap requests to 
the CPU whenever certain conditions occur. These traps and the conditions that cause them are 
shown in Table 7-1. Trap 23, reference to unavailable resource, and Trap 24, bus parity or 
uncorrected main memory error, are functions of the megabus. Trap 20, program error, 
identifies program errors detected by the SIP. Note that program errors detected by the CPU 
activate Trap 16. If more than one trap condition exists, the SIP sends the trap with the highest 
priority to the CPU. The other conditions are lost. The priority of the traps is indicated in Table 


5-1 by their location; the trap at the top (Trap 31) has the highest priority. 


TABLE 7-1. TRAP VECTORS AND EVENTS 


Trap 

Vector Scientific Scientific SIP-CPU 

Number Trap Event C/U , Indicator Mask Trap Code 
TV31 QLT Failure (Mini or Maxi) u — ae 21 
TV23 Reference to Unavail- u — _ 29 

able Resources 

TV24 Megabus/Memory Error u — — | 28 
TV20 Program Error (SIP) u — — 2C 
TV7 Divide by Zero u — — 39 
TV8 Exponent Overflow u — — 38 
TV21_ Significance Error c SI(SE) MS5(SE) 2B 
TV19 Exponent Underflow c SI(EUF) M5(EUF) 2D 
TV22_ Precision Error c SI(PE) M5(PE) 2A 
TV00 No Trap Event Set — — — 00 


aC — Conditioned Trap on Indicator and Mask 
U — Unconditioned Trap 
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SCIENTIFIC INSTRUCTION PROCESSOR (SIP) 
PROGRAMMING CONSIDERATIONS 


Since the SIP and the Level 6 central processor operate asynchronously, you must ensure that 
they do not come into conflict by attempting to use a main memory operand concurrently. You 
can guarantee proper synchronization by obeying the following rules: 


If the operand of any of the following instructions refers to a main memory location, do not 
modify that location until a scientific branch instruction or another floating-point instruction is 
executed: | 


SAD SML 
SCM SNGD 
SCZD SNGQ 
SCZQ SSB 
SDV SST 
SLD SSW 
The instruction: 
SST $S1, = $S1 


can be used to force the SIP into synchronization with the CPU. 
DETAILED DESCRIPTIONS OF SCIENTIFIC INSTRUCTIONS 


The remainder of this section contains detailed descriptions of the scientific instructions. The © 


descriptions are arranged in alphabetical sequence by instruction mnemonics. Each description 
includes the name, type, format, and operands. Symbolic names, constants and expressions are 
described in Section 2. 


SAD 


Instruction: 
Scientific add 


Type: 
DO 
Source Language Format: 
ty eon 
ASADA X‘n’ } ,address-expression 
n 
Description: 


Adds the floating-point or integer value in the location, scientific accumulator, or R-register 
identified in the second operand to the contents of the scientific accumulator specified in the 
first operand. The result is saved in the scientific accumulator. | 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Bn register addressing 
Short displacement addressing 
Specialized addressing 


If register addressing is used, the valid forms are: 


OT > 


If =$R7 is specified, the 32-bit value contained in the register pair 


=e formed by R6 and R7 becomes the operand. 


“1 oO) 


=$Sn 
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If immediate operand addressing is used, you must provide a floating-point constant or 
hexadecimal string constant in suitable floating-point format. 


If the second operand is =$R4, =$R5, =$R6, or =$R7, the integer value contained in the 
specific R-register is internally converted to floating-point format before it is added to the 
contents of the S-register specified by the first operand. 


Scientific Indicator Settings: 


EU: set to 1 on exponent underflow; otherwise, set to 0. 
PE: set to 1 if nonzero bits are lost during right shift; otherwise, set to 0. 


If the SIP is not installed, the SIP simulator, if present, is entered via trap vector 3. 
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SBE | : . 


SBE 
Instruction: 

Scientific branch on equal 
Type: 

BI 


Source Language Format: 


direct-IMA 
ASBEA direct-P-relative-address 
short-displacement-address 


Description: 
Branches to the location specified in the operand if both the SL- and SG-bits of the SI-register 
are set to 0. 

Action if Branch Occurs: 


If the J-bit in the M1l-register contains a binary 1, the trace procedure is entered via trap 
vector 2. Upon completion, the trace procedure automatically branches to the address 
specified by the operand. In this case, or if the J-bit contains a binary 0, the instruction 
sequence starting at the location specified by the operand is executed. 


If the Scientific Information Processor (SIP) is not installed on this system, the Scientific 
Branch Simulator, if present, is entered via trap vector 5. 
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SBEU 


SBEU 
| Instruction: 
Scientific branch on exponent underflow 
Type: 
BI 


Source Language Format: 


direct-IMA 
ASBEUA direct-P-relative-address 
short-displacement-address 


Description: 
Branches to the location specified in the operand if the EU-bit in the SI-register is set to 1. 
Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap 
vector 2. Upon completion, the trace procedure automatically branches to the address 
specified by the operand. In this case, or if the J-bit contains a binary 0, the instruction 
sequence starting at the location specified by the operand is executed. 


If the Scientific Information Processor (SIP) is not installed on this system, the Scientific 
Branch Simulator, if present, is entered via trap vector 5. 
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SBEZ 


SBEZ 


Instruction: 

Branch if scientific accumulator equal to 0 
Type: | 

BR 


Source Language Format: 


$Sn direct-IMA 
ASBEZA X‘n’} , ¢ direct-P-relative-address 
n short-displacement-address 


Description: 
Branches to the location specified in the second operand if the scientific accumulator 
identified in the first operand contains a floating-point value algebraically equal to 0. 
Action if Branch Occurs: 


If the J-bit in the Ml-register contains a binary 1, the trace procedure is entered via trap 
vector 2. Upon completion, the trace procedure automatically branches to the address 
specified by the operand. In this case, or if the J-bit contains a binary 0, the instruction 
sequence starting at the location specified by the operand is executed. 


If the Scientific Information Processor (SIP) is not installed on this system, the Scientific 
Branch Simulator, if present, is entered via trap vector 5. 
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SBG 


SBG 
Instruction: 
Scientific branch on greater than 
Type: 
BI 
Source Language Format: 


direct-IMA 
ASBGA direct-P-relative-address 
short-displacement-address, 


Description: 
Branches to the location specified in the operand if the SG-bit in the SI-register is set to 1. 


Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap 
vector 2. Upon completion, the trace procedure automatically branches to the address speci- 
fied by the operand. In this case, or if the J-bit contains a binary 0, the instruction sequence 
starting at the location specified by the operand is executed. 


If the Scientific Information Processor (SIP) is not installed on this system, the Scientific 
Branch Simulator, if present, is entered via trap vector 5. 
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SBGE 


SBGE 
Instruction: | 

Scientific branch on greater than or equal 
Type: 

BI 


Source Language Format: 
direct-IMA 
ASBGEA direct-P-relative-address 
short-displacement-address 
Description: 
Branches to the location specified in the operand if the SL-bit of the Sl-register is set to 0. 


Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap 
vector 2. Upon completion, the trace procedure automatically branches to the address speci- 
fied by the operand. In this case, or if the J-bit contains a binary 0, the instruction sequence 
starting at the location specified by the operand is executed. 


If the Scientific Information Processor (SIP) is not installed on this system, the Scientific 
Branch Simulator, if present, is entered via trap vector 5. 
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SBGEZ 
Instruction: 

Branch if scientific accumulator equal to or greater than 0. 
Type: 

BR 


Source Language Format: 


$Sn direct-IMA 
ASBGEZA X‘n’}, 4 direct-P-relative-address 
n short-displacement-address 


Description: 


Branches to the location specified in the second operand if the scientific accumulator identi- 
fied in the first operand contains a nonnegative floating-point value. 


Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap 
vector 2. Upon completion, the trace procedure automatically branches to the address speci- 
fied by the operand. In this case, or if the J-bit contains a binary 0, the instruction sequence 
starting at the location specified by the operand is executed. 


If the Scientific Information Processor (SIP) is not installed on this system, the Scientific 
Branch Simulator, if present, is entered via trap vector 5. 
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SBGZ 


SBGZ 
Instruction: 

Branch if scientific accumulator greater than 0 
Type: 

BR 


Source Language Format: 


$Sn direct-IMA 
ASBGZA X‘n’ > ,{ direct-P-relative-address 
n short-displacement-address 


Description: 
Branches to the location specified in the second operand if the scientific accumulator identi- 
fied in the first operand contains a positive floating-point value. 

Action if Branch Occurs: 


If the J-bit in the M1-register contains binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by 
the operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting 
at the location specified by the operand is executed. 


If the Scientific Information Processor (SIP) is not installed on this system, the Scientific 
Branch Simulator, if present, is entered via trap vector 5. 
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SBL 


SBL 


Instruction: 

Scientific branch if less than 
Type: 

BI 


Source Language Format: 


direct-IMA 
ASBLA direct-P-relative-address 
short-displacement-address 


Description: 


Branches to the location specified in the operand if the SL-bit of the Sl-register is set to 1. 


Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure automatically branches 
to the address specified by the operand. In this case, or if the J-bit contains a binary 0, the 
instructions sequence starting at the location specified by the operand is executed. 


If the Scientific Information Processor (SIP) is not installed on this system, the Scientific 
Branch Simulator, if present, is entered via trap vector 5. 
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SBLE 


SBLE 
Instruction: 

Scientific branch on less than or equal 
Type: 

BI 


Source Language Format: 


| direct-IMA 
ASBLEA direct-P-relative-address 
short-displacement-address 


Description: 


Branches to the location sited in the operand if the SG-bit in the SI-register is set to 0. 


Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap 
vector 2. Upon completion, the trace procedure automatically branches to the address speci- 
fied by the operand. In this case, or if the J-bit contains a binary 0, the instruction sequence 
starting at the location specified by the operand is executed. 


If the Scientific Information Processor (SIP) is not installed on this system, the Scientific 
Branch Simulator, if present, is entered via trap vector 5. 
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SBLEZ 


SBLEZ 
Instruction: 

Branch if scientific accumulator equal to or less than 0 
Type: 

BR 


Source Language Format: 


$Sn direct-IMA 
ASBLEZA X‘n’ }, } direct-P-relative-address 
n short-displacement-address 


Description: 
Branches to the location specified in the second operand if the scientific accumulator identi- 
fied in the first operand contains a floating-point value algebraically equal to or less than 0. 
Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap 
vector 2. Upon completion, the trace procedure automatically branches to the address speci- 
fied by the operand. In this case, or if the J-bit contains a binary 0, the instruction sequence 
starting at the location specified by the operand is executed. 


If the Scientific Information Processor (SIP) is not installed on this system the Scientific 
Branch Simulator, if present, is entered via trap vector 5. 
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~SBLZ 


SBLZ | oN 
Instruction: ed 


Branch if scientific accumulator less than 0 


Type: 
BR 


Source Language Format: 


$Sn direct-IMA 
ASBLZA X‘n’}, ¢ direct-P-relative-address 
n short-displacement-address 


Description: | 
Branches to the location specified in the second operand if the scientific accumulator identi- 
fied in the first operand contains a negative floating-point value. 

Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1 the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by 

_the operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting 
at the location specified by the operand is executed. 


If the Scientific Information Processor (SIP) is not installed on this system, the Scientific | 
Branch Simulator, if present, is entered via trap vector 5. 
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SBNE 


( - SBNE 


Instruction: 


Scientific branch on not equal 


Type: 
BI 


Source Language Format: 


direct-IMA 
ASBNEA direct-P-relative-address 
short-displacement-address 


Description: 
Branches to the location specified in the operand if either the SL- or SG-bit of the SI-register is 
set to l. 

Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap 
vector 2. Upon completion, the trace procedure automatically branches to the address speci- 
fied by the operand. In this case, or if the J-bit contains a binary 0, the instruction sequence 
starting at the location specified by the operand is executed. 


If the Scientific Information Processor (SIP) is not installed on this system, the Scientific 
Branch Simulator, if present, is entered via trap vector 5. 
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SBNEU 


Instruction: 


Scientific branch on not exponent underflow 


Type: 
BI 


Source Language Format: 


direct-IMA 
ASBNEUA direct-P-relative-address 
short-displacement-address 
Description: 
Branches to the location specified in the operand if the EU-bit of the Sl-register is set to 0. 


Action if Branch Occurs: 


If the J-bit of the M1-register contains a binary 1, the trace procedure is entered via trap 
vector 2. Upon completion, the trace procedure automatically branches to the address speci-. 
fied by the operand. In this case, or if the J-bit contains a binary 0, the instruction sequence 
starting at the location specified by the operand is executed. 


If the Scientific Information Processor (SIP) is not installed on this system, the Scientific 
Branch Simulator, if present, is entered via trap vector 5. 
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SBNEZ 
"Instruction: | 

Branch if scientific accumulator not equal to 0 
Type: 

BR 


Source Language Format: 


$Sn direct-IMA 
ASBNEZA X‘n’?, 4 direct-P-relative-address 
n short-displacement-address 


Description: 
Branches to the location specified in the second operand if the scientific accumulator identi- 
fied in the first operand contains a floating-point value not algebraically equal to 0. 
Action if Branch Occurs: 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap 
vector 2. Upon completion, the trace procedure automatically branches to the address 
specified by the operand. In this case, or if the J-bit contains a binary 0, the instruction 
sequence starting at the location specified by the operand is executed. 


If the Scientific Information Processor (SIP) is not installed on this system, the Scientific 
Branch Simulator, if present, is entered via trap vector 5. 
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SBNPE | a 2 
Instruction: | 
Scientific branch on not precision error 
Type: 
BI 


Source Language Format: 


direct-IMA 
ASBNPEA direct-P-relative-address 
short-displacement-address 


Description: 


Branches to the location specified in the operand if the PE-bit of the SI-register is set to 0. 


Action if Branch Occurs: 


If the J-bit of the M1l-register contains a binary 1, the trace procedure is entered via trap 
vector 2. Upon completion, the trace procedure automatically branches to the address speci- 
fied by the operand. In this case or if the J-bit contains a binary 0, the instruction sequence 
starting at the location specified by the operand is executed. 


If the Scientific Information Processor (SIP) is not installed on this system, the Scientific 
Branch Simulator, if present, is entered via trap vector 5. 
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SBNSE 
Instruction: 
Scientific branch on not significance error 
Type: 
BI 
Source Language Format: 


direct-IMA 
ASBNSEA direct-P-relative-address 
short-displacement-address 


Description: 


Branches to the location specified in the operand if the SE-bit of the Sl-register is set to 0. 


Action if Branch Occurs: 


If the J-bit in the M1-register contains binary 1, the trace procedure is entered via trap vector 
2. Upon completion, the trace procedure automatically branches to the address specified by 

. the operand. In this case, or if the J-bit contains a binary 0, the instruction sequence starting 
at the location specified by the operand is executed. 


If the Scientific Information Processor (SIP) is not installed on this system, the Scientific 
Branch Simulator, if present, is entered via trap vector 5. 
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SBPE 
Instruction: 
Scientific branch on precision error 
Type: | 
BI 


Source Language Format: 


direct-IMA 
ASBPEA _ direct-P-relative-address 
short-displacement-address 


Description: 
Branches to the location specified in the operand if the PE-bit of the Sl-register is set to 1. 


Action if Branch Occurs: 


If the J-bit of the 1-register contains a binary 1, the trace procedure automatically branches to 
the address specified by the operand. In this case, or if the J-bit contains a binary 0, the 
instruction sequence starting at the location specified by the operand is executed. 


If the Scientific Information Processor (SIP) is not installed on this system, the Scientific 
Branch Simulator, if present, is entered via trap vector 5. 
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SBSE 
Instruction: 

Scientific branch on significance error 
Type: 

BI 


Source Language Format: 


direct-IMA 
ASBSEA direct-P-relative-address 
short-displacement-address 


Description: 


Branches to the location specified in the operand if the SE-bit of the SI-register is set to 1. 


Action if Branch Occurs: 


If the J-bit of the M1-register contains a binary 1, the trace procedure is entered via trap 
vector 2. Upon completion, the trace procedure automatically branches to the address 
specified by the operand. In this case, or if the J-bit contains a binary 0, the instruction 
sequence starting at the location specified by the operand is executed. 


If the Scientific Information Processor (SIP) is not installed on this system, the Scientific 
Branch Simulator, if present, is entered via trap vector 5. 
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SCM | eos 
Insstruction: , | ar, 


Scientific compare 


Type: 
DO 
Source Language Format: 
| $Sn 
ASCMA X‘n’ } ,address-expression 
n 
Description: 


Compares the contents of the scientific accumulator identified in the first operand to the 
floating-point or integer value in the location, scientific accumulator, or R-register specified 
in the second operand. 


Scientific Indicator Settings: 


SG: Set to 1 if contents of the scientific accumulator identified by the first operand are 
greater than the value specified by the second operand location; otherwise, set to 0. 
SL: Set to 1 if contents of the scientific accumulator identified by the first operand are less 
than the value specified by the second operand location; otherwise, set to 0. 
PE: Set to 1 if nonzero bits are lost during right shift for scaling before comparison; 
otherwise, set to 0. 
If the Scientific Information Processor (SIP) is not installed on this system, the iateaghon 
causes the Floating-Point Simulator, if present, to be entered via trap vector 3. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques” except for the following: 


=$Bn register addressing 
Short displacement addressing 
Specialized addressing 


If register addressing is used, the valid forms are: 


If =$R7 is specified, the 32-bit value contained in the 


=e register pair formed by R6 and R7 becomes the operand. 


IO op 


=$Sn | 
If immediate operand addressing is used, you must provide a floating-point constant or string 
constant in suitable floating-point format. : 


If the second operand is =$R4, =$R5, =$R6, or =$R7, the integer value contained in the 
specified R-register is internally converted to floating-point format before it is compared to 
the S-register specified by the first operand. 
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SCZD 


SCZD 
( ; Instruction: 

7 Scientific compare to zero (short-precision) 
Type: 

SO 


Source Language Format: 
ASCZDAaddress-expression 


Description: 


Compares the short-precision floating-point value in the specified location to 0. 


Scientific Indicator Settings: 


SG: Set to 1 if the contents of the location are greater than 0; otherwise, set to 0. 

SL: Set to 1 if the contents of the location are less than 0; otherwise, set to 0. 

PE: Set to 1 if nonzero bits are lost during right shift for scaling before comparison; 
otherwise, set to 0. 


If the Scientific Information Processor (SIP) is not installed on this system, the instruction 
causes the Floating-Point Simulator, if present, to be entered via trap vector 3. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 
=$Bn 
= $Rn \ register addressing 
=$Sn 
7 Short displacement addressing 
( Specialized addressing 
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SCZQ 


SCZQ 
Instruction: 
Scientific compare to 0 (long-precision) 
Type: | 
SO 
Source Language Format: 
ASNZQAaddress-expression 


Description: 


Compares the floating-point value in the specified location to 0. 
Scientific Indicator Settings: 


SG: Set to 1 if the contents of the location are greater than 0; otherwise, set to 0. 

SL: Set to 1 if the contents of the location are less than 0; otherwise, set to 0. 

PE: Set to 1 if nonzero bits are lost during right shift for scaling before comparison; 
otherwise, set to 0. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 

=$Bn 

=$Rn \ register addressing 

=$Sn 

Short displacement addressing 

Specialized addressing 
If immediate operand addressing is used, you must provide a string constant in suitable 
floating-point format. : 
If the Scientific Information Processor (SIP) is not installed on this system, the Floating-Point 
Simulator, if present, is entered via trap vector 3. 
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SDV 


SDV 
Instruction: 
Scientific divide 
Type: 
DO 


Source Language Format: 


$Sn 
ASDVA { X‘n’ } ,address-expression 
n 
Description: 
Divides the contents of the scientific accumulator identified by the first operand by the 
contents of the location, scientific accumulator, or R-register specified in the second operand. 
The result is saved in the scientific accumulator identified by the first operand (except for the 
remainder, which is ignored). , 
If the Scientific Instruction Processor (SIP) is not installed on this system, the Floating-Point 
Simulator, if present, is entered via trap vector 3. 
The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 
=$Bn register addressing 


Short displacement addressing 
Specialized addressing 


If register addressing is used, the valid forms are: 
4 : 
5 (If =$R7 is specified, the 32-bit value contained in the 
=$R )6 register pair formed by R6 and R7 becomes the operand. 
7 : 
=$§Sn 
If the second operand is =$R4, =$R5, =$R6, or =$R7, the integer value contained in the 
specific R-register is internally converted to floating-point format before it is divided into the 
contents of the S-register specified by the first operand. 
If immediate operand addressing is used, you must provide a floating-point constant or string 
constant in suitable floating-point format. 
If the second operand is =$R4, =$R5, =$R6, or =$R7, the integer value contained in the 
specific R-register is internally converted to.floating-point format before it is added to the 
contents of the S-register specified by the first operand. 
Scientific Indicator Settings: 


EU: Set to 1 on exponent underflow; otherwise, set to 0. 
PE: Set to 1 if nonzero bits are list during right shift; otherwise, set to 0. 
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SLD 


Instruction: 


Scientific load 


Type: 
DO 


Source Language Format: 


$Sn 
ASLDA ¢ X‘n’$ ,address-expression 
n 
Description: | 
Loads the contents of the location, scientific accumulator, or R-register identified in the 
second operand into the scientific accumulator identified in the first operand. 
If the Scientific Instruction Processor (SIP) is not installed on this system, the Floating-Point 
Simulator, if present, is entered via trap vector 3. 
The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 
=$Bn register addressing 
Short displacement addressing 
Specialized addressing 


If register addressing is used, the valid forms are: 


If =$R7 is specified, the 32-bit value contained in the 


=$R register pair formed by R6 and R7 becomes the operand. 


“I OF 


=$Sn 


If immediate operand addressing is used, you must provide a floating-point constant or string 
constant in suitable floating-point format. 


If the second operand is = $R4, =$R5, =$R6, or =$R7, the integer value contained in the 
specific R-register is internally converted to floating-point format before it is added to the 
S-register specified by the first operand. 

Scientific Indicator Settings: 


EU: Set to 1 on exponent overflow; otherwise, set to 0. 
PE: Set to 1 if nonzero bits are lost during right shift; otherwise, set to 0. 
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SML 


Instruction: 


Scientific multiply 


Type: 
DO 


Source Language Format: 


$Sn 
ASMLA ¢ X‘n’} ,address-expression 
til 
Description: 
Multiplies the contents of the scientific accumulator identified by the first operand by the 
contents of the location, scientific accumulator, or R-register specified in the second operand. 
The result is saved in the scientific accumulator identified by the first operand. 


If the Scientific Instruction Processor (SIP) is not installed on this system, the Floating-Point 
Simulator, if present, is entered via trap vector 3. | 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Bn register addressing 
Short displacement addressing 
Specialized addressing 


If register addressing is used, the valid forms are: 


4 

=$R 5 | If =$R7 is specified, the 32-bit value contained in the 
6 { register pair formed by R6 and R7 becomes the operand. 
7 


=$Sn 
If immediate operand addressing is used, you must provide a floating-point constant or string 
constant in suitable floating-point format. 


If the second operand is an R-register the integer value contained in the specific R-register is 
internally converted to floating-point format before it is multiplied by the contents of the 
S-register specified by the first operand. 

Scientific Indicator Settings: 


EU: Set to 1 on exponent underflow; otherwise, set to 0. 
PE: Set to 1 if nonzero bits are lost during right shift; otherwise, set to 0. 
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SNGD 


SNGD | | | oe - 
Instruction: 7 7 
Scientific negate (short-precision) 
Type: 
SO 


Source Language Format: 
ASNGDAaddress-expression 


Description: 


Negate the short precision floating-point number at the location or in the scientific ac- 
cumulator specified by the operand. 

If the Scientific Instruction Processor (SIP) is not installed on this system, the Floating-Point 
Simulator, if present, is entered via trap vector 3. 

The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Bn 
= $Rn 
Short displacement addressing 
Specialized addressing 


register addressing 


The only valid form of register addressing is: 


=$§Sn 


SCIENTIFIC INSTRUCTIONS 1-28 | _ CBO7 


SNGQ 


SNGQ 
Instruction: 

Scientific negate (long-precision) 
Type: 

SO 
Source Language Format: 

ASCGQ4Aaddress-expression 

Description: 


Negate the long-precision floating-point number at the location or in the scientific ac- 
cumulator specified by the operand. 


If the SIP is not installed on this system, the Floating-Point Simulator, if present, is entered 
via trap vector 3. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


an register addressing 


Short displacement addressing 
Specialized addressing 


The only valid form of register addressing is: 
=$Sn 
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SSB 


SSB | 
Instruction: 


Scientific subtract 


Type: 
DO 


Source Language Format: 


$Sn | 
ASSBA { X‘n’} ,address-expression 
a | 


Description: 
Subtracts the contents of the location, scientific accumulator, or R-register identified by the 


second operand from the contents of the scientific accumulator specified by the first operand. 
The result is saved in the scientific accumulator. 


If the Scientific Instruction Processor (SIP) is not installed on this system, the Floating-Point 
Simulator, if present, is entered via trap vector 3. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Bn register addressing 
Short displacement addressing 
Specialized addressing 


If register addressing is used, the valid forms are: 


4 
=$R 5 (If =$R7 is specified, the 32-bit value contained in the 


6 {register pair formed by R6 and R7 becomes the operand. 
7 


=$Sn 


If immediate operand addressing is used, you must provide a floating-point constant or string 
constant is suitable floating-point format. 


If the second operand is an R-register, the integer value contained in the specific R-register is 
internally converted to floating-point format before it is subtracted from the contents of the 
S-register specified by the first operand. 


Scientific Indicator Settings: 


EU: Set to 1 on exponent underflow; otherwise, set to 0. 
PE: Set to 1 if nonzero bits are lost during right shift; otherwise, set to 0. 
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SST 


SST , 


Instruction: 


Scientific store 


Type: 
DO 
Source Language Format: 
$Sn 
ASSTA 4 X‘n’} ,address-expression 
n 
Description: 
Stores the contents of the scientific accumulator identified by the first operand in the location, 
scientific accumulator, or R-register specified by the address expression. 
If the Scientific Instruction Processor (SIP) is not installed on this system, the Floating-Point 
Simulator, if present, is entered via trap vector 3. 
The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 
=$Bn register addressing 


Short displacement addressing 
Specialized addressing 


If register addressing is used, the valid forms are: 


4 

-$R 5 (If =$R7 is specified, the 32-bit value contained in the 
6{ register pair formed by R6 and R7 becomes the operand. 
7 

=$Sn 


If immediate operand addressing is used, you must provide a floating-point constant or string, 
constant in suitable floating-point format. 
If the second operand is an R-register, the floating-point value contained in the specific 
scientific accumulator is converted to integer format before it is stored into the specified 
R-register. 

Scientific Indicator Settings: 


EU: Set to 1 on exponent underflow; otherwise, set to 0. 
SE: Set to 1 if resultant floating-point value has a zero fraction; otherwise, set to 0. 
PE: Set to 1 if nonzero bits are lost during right shift; otherwise, set to 0. 
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SSW 


SSW ‘ 


Instruction: 


Scientific swap 


Type: 
DO 


Source Language Format: 


$Sn 
ASSWA { X‘n’} ,address-expression 
n 
Description: 
| Swaps the contents of the scientific accumulator identified by the first operand with the 
contents of the location, scientific accumulator, or R-register specified by the address expres- — 
sion. 
If the Scientific Instruction Processor (SIP) is not installed on this system, the Floating-Point 
Simulator, if present, is entered via trap vector 3. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Bn register addressing 
Short displacement addressing 
Specialized addressing — 


If register addressing is used, the valid forms are: 


4 

5 (If =$R7 is specified, the 32-bit yalue contained in the 

6 (register pair formed by R6 and R7 becomes the operand. 
7 


=$§R 


=$Sn 


If immediate operand addressing is used, you must provide a floating-point constant or string 
constant in suitable floating-point format. 

If an R-register is specified as the second operand, the value specified by the first operand is 
internally converted to integer format, and the value specified by the second operand is 
internally converted to floating-point. These converted values are then interchanged. 

The address expressions can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Rn ; 

=$Sn register addressing 

Short displacement addressing 

Specialized addressing | 
Scientific Indicator Settings: 


EU: Set to 1 on exponent underflow; otherwise, set to 0. 
SE: Set to 1 if resultant floating-point value has a zero fraction; otherwise, set to 0. 
PE: Set to 1 if nonzero bits are lost during right shift; otherwise, set to 0. 


fo* 
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Section 8 


Macro Facility 


The Macro Preprocessor is a program development tool that provides a convenient method for 
including in a source module sequences of statements that are specified in a macro routine. 


A macro routine is a block of source code that is written only once and can be included multiple 
times within a given source program. A single statement, known as a macro call, is specified in 
the source program each time the sequence of statements is to be included. A source program 
containing one or more macro calls is called an unexpanded source program. Macro routines can 
be at the beginning of a source program or in a macro library; those occurring with a source 
program are called inline macro routines. 


The Macro Preprocessor produces an expanded source program which is used as input to the 
Assembler. The expanded source program may contain an error flag for each nonfatal error. 
Each statement that contains a nonfatal error flag appears in the expanded source module as a 
comment statement with the appropriate error. (Nonfatal error flags are described in Appendix 
F.) If a fatal error occurs, processing terminates, an error message is issued to the error-out 
stream, and control returns to the Command Processor. (Error messages issued by the Macro 
Preprocessor are described in the System Messages manual.) 


NOTE: 
Honeywell provides a library of macro routines that support MLCP programming. 
(See the MLCP Programmer’s Reference Manual.) 


ORDER OF STATEMENTS WITHIN A SOURCE PROGRAM 


Statements within a source program must be in the order listed below: 

1. TITLE Assembler control statement. 

2. LIBM macro control statements and/or macro routines delimited by MAC and ENDM 
macro control! statements. 


(Optional) LIST or NLST Assembler control statement 
(Optional) comment statements 


Note: 
LIBM statements, macro routines, comment statements, and a LIST or NLST 
statement can be intermixed. 
3. Statements that constitute the body of the source module; includes macro calls. 


END Assembler control statement. Identifies the end of the assembly language program. 
Statements subsequent to this statement will be ignored by the Assembler. If this 
statement is missing, both the Assembler and the Macro Preprocessor will generate an 
END statement. | 


Macro control statements and macro calls are described in this section. Assembler control 
statements are described in Section 4. 


MACRO ROUTINES 


A macro routine can be either generalized or specialized. A generalized macro routine causes 
a fixed expansion in the source module. A specialized macro routine permits specified values to 
be included in the expanded source module. 
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MAC WITHOUT PARAMETERS / ENDM 


The following information is described below. 
e Creating a macro routine 

e Specializing a macro routine 

e Including protection operators 


e Situating a macro routine 


CREATING A MACRO ROUTINE 


A macro routine must be preceded by a MAC macro control statement and followed by an 
ENDM macro control statement. — 


MAC MACRO CONTROL STATEMENT, WITHOUT PARAMETERS 


The MAC statement assigns a name to a macro routine; it must immediately precede every 
macro routine. MAC must be the last entry on the source line, or it must be immediately 
followed by a comma and an optional comment. 


Format: 
- macro-nameAMAC | [comment] | 
macro-name 


Name of the macro routine; must be a valid symbolic name. To include the macro routine 
within a source module, specify the macro name in a macro call. 


Note: 


A macro routine can be specialized by including macro parameters in the MAC 
statement. (See “MAC Macro Control Statement, Including Parameters” later in 
this section.) | 


CONTENTS OF MACRO ROUTINE 
A macro routine can include: 
-e Macro control statements, excluding MAC and ENDM 
e Macro functions 
e Assembler control statements, excluding END 
e Assembly language statements 


Macro control statements and macro functions are described in this section. Assembler control 
statements and. assembly language statements are described in Sections 4 and 5 through 7, 
respectively. 
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ie 
Mee v 
fi 

lve = cy a 


ENDM / MAC WITH PARAMETERS 


( ws ENDM MACRO CONTROL STATEMENT 


The ENDM statement designates the end of a macro routine; it must immediately follow each 
macro routine. 


Format: 
[label JAENDM 


label 
Symbolic name that identifies the ENDM statement. 


SPECIALIZING A MACRO ROUTINE BY PARAMETER SUBSTITUTION 


In a given macro routine, up to 85 different macro parameters can be referenced. Parameters 
are named P1 to P9 and PA to PZ. (The lowercase letters are considered to be equivalent to the 
corresponding uppercase letters.) Each parameter name must be preceded by a substitution 


operator ,°?”, (question mark) to indicate that substitution will occur, i.e., a value will be 
substituted. 


Macro parameters can be assigned values in the MAC statement and/or in macro calls. 


When a macro call is specified, each macro parameter reference in the requested macro 
routine is replaced with the parameter’s value. If a parameter was assigned a value in the MAC 
statement and then assigned a different value in the macro call, the value specified in the macro 
call isthe value of the parameter. If no value was specified in the MAC statement or in the macro 
call, the parameter is equal to a null character string. 
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MAC WITH PARAMETERS 


MAC MACRO CONTROL STATEMENT, INCLUDING PARAMETERS 


The MAC statement assigns a name to a macro routine and optionally assigns default value 
macro parameters. 
Format: | 
macro-nameAMAC AP, =v] ,P ,f=v] 
macro-name 
Name of the macro routine being created; must be a valid symbolic name. 
P, 


Macro parameter name; can be from the set P1 through P9 or from the set PA through PZ. 
Parameter names can be specified in any order. 


NOTE: 
It may be impossible to specify all parameters on one source line. Parameters 
can be continued on the next line by replacing the last comma with a semicolon. 
(See “Assembly Language Source Statement Formats” in Section 3.) 


Value of macro parameter; can be any alphanumeric characters. (See “Desig- 
nating Alphanumeric Values” at the end of this section.) 


If a value is not specified, the corresponding parameter remains equal to a null character 
string. 


Example: 


This example illustrates an unexpanded source module that includes a MAC statement with 
parameters. The resulting expanded source module includes those parameter values. 


Unexpanded source module: 


TITLE EXMPL 
SAMPLE MAC P3=5; Designates beginning of macro routine and 
PB='6,’ assigns values to parameters P3 and PB 

LDV $R1=?P3 

Statements to be included in source module 

LDR $R2=?PB 
FINI ENDM Designates end of macro routine 

SAMPLE Macro call requesting macro routine named 


SAMPLE 


Expanded source module: 


TITLE EXMPL 
penbaiias Macro call replaced by contents of macro 
LDR $R2='6,' routine named SAMPLE 
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MAC WITH PARAMETERS 


PROTECTION OPERATORS 


Protection operators are brackets; they enclose one or more characters that are not to be 
interpreted by the Macro Preprocessor. Protection operators can be included in macro routines 
and/or in statements that constitute the body of a source program. 


NOTE: 
Brackets illustrated in each command’s Format are not protection operators; they 
enclose optional characters. 
Example: 


This example illustrates an unexpanded source module, which includes protection operators, 
and the resulting expanded source module. 


Unexpanded source module: 


TITLE EXMPL 
SAMPLE MAC P7=3 Designates beginning of macro routine and 

assigns value to parameter P7 

NEWA [?] P7 Substitution operator will not be inter- 
preted by Macro Preprocessor, so no value 
will be substituted 

NEWB ?P7 Reference to P7 will be replaced with its 
value 

ENDM Designates end of macro routine 

[SAMPLE] Not interpreted as macro call because name 

‘ of macro routine is enclosed within protec- 
tion operators 

SAMPLE Macro call; in the expanded source module 


will be replaced by contents of macro rou- 
tine named SAMPLE 


Expanded source module: 


TITLE EXMPL 
SAMPLE 


NEWA ?P7 
Contents of macro routine named SAMPLE 
NEWB 3 


Protection operators cannot extend over operand or argument delimiters; to protect adjacent 
operands or arguments, enclose each one individually in brackets. 


Example 1: 
FOOA[AB],[CD] 

The above macro call FOO designs that parameter P1 equals [AB] and parameter P2 equals 

[CD]. 

Example 2: 
FOOA[AB,CD] 


The above macro call FOO is not equivalent to the macro call illustrated in example 1. The 
macro call in example 2 specifies that parameter P1 equals [AB and parameter P2 equals CD] 
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MAC WITH PARAMETERS 


If any part of a label or operation code is protected, the entire label or operation code is 
protected. | 


Example: 
LAB[ELJALD[R]A$R1,= 100 
The above statement is considered to have no label and no operation code. 


Protection operators do not appear in expanded source modules unless the operators are 
embedded in other protection operators. 


Example 1: 
NEWA[?]P7 
The above statement appears in the expanded source module as NEWA?P7. 


Example 2: 

DC ‘A[BC[DEF]GH]I 
The above statement appears in the expanded source module as DCA’ABC[DEF]GHI’. Only the 
outermost protection operators are removed, unless the expanded source module is then 
reprocessed by the Macro Preprocessor. 
_ Protected comment statements appear in the expanded source module with the protection 
operators removed. If protected comment statements appear in a macro routine, they are 
substituted in the expanded source module as described previously. Unprotected comment 
statements which appear in a macro routine are considered to document the macro routine 
itself; thus they are not substituted into, the expanded source module. 


Example: 
ABC MAC 
HLT 
*COMNT1 
[*|}JCOMNT2 
ENDM | 
In the above example COMNT2 is considered a macro routine comment and will appear in the 
expanded source module as 


*COMNT2 


COMNT1 is not considered a macro routine comment and will not appear in the expanded source 
module. | | 


SITUATING MACRO ROUTINES 


Macro routines can be in the source module in which they are requested by macro call(s) 
and/or in macro libraries on a mass storage volume. A macro library is a directory whose files are 
macro routines. Each file must be a single macro routine that is referenced in a macro call by its 
file name. Its file name must be identical to the label of its MAC statement. 


All macro routines within a source module must be at the beginning of the module. (See 
“Order of Statements Within a Source Module” earlier in this section.) 
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LIBM 


LIBM MACRO CONTROL STATEMENT 


The LIBM statement specifies the name of a macro library and indicates whether all or only 
specified macro routines in that library will be made available so that they can be requested in 
subsequent macro calls. If applicable, you must specify LIBM statement(s) at the beginning of 
the source program. 


Format: 


ALIBMA | symbolic-name 


symbolic-name 

Name ofa macro library. A macro library is a directory containing a collection of files. Each file 
in a macro library consists of a single macro routine. The following search rules are used to 
locate the macro library referenced by a symbolic-name. | 

1. Thecu..ent working directory is searched for a subdirectory of the name, symbolic-name. 
If this directory is found, it is the directory used as the macro library. 

2. The directory >UDD>account>MACRO, if it exists, is searched for a subdirectory of the 
name, symbolic-name. If this directory is found, it is the directory used as the macro 
library. 

3. The directory >LDD>MACRO, if it exists, is searched for a subdirectory of the name, 
symbolic-name. If this directory is found, it is the directory used as the macro library. 
The volume(s) containing the system directories SYSLIB1 and SYSLIB2 are searched to 
find the >LDD>MACRO directory. It may require the Change System Directory com- 
mand to identify the pathname of SYSLIB1 and/or SYSLIB2. 

[A}cle...] 
Name of a macro library in the form of an ASCII string constant. If the value of the string, 
constant is a simple name, it is processed as a symbolic-name. 
If the value of the string constant is not a simple name, it is expanded to an absolute 
pathname, which is assumed to be the name of the desired macro library. 

macro-name 
Name(s) of macro routine(s) in the macro library that may be requested in macro call(s); 
must be a valid symbolic name. The names must be different from the names of inline macro 
routines else the inline macro routine is used. 
Default: All macro routines in the specified macro library may be included in the expanded 
source module by subsequent macro calls. 


Example of Search Rules for Locating a Macro Library 
This example of the search rules is based on the following assumptions: 

e The current working directory is “ YVOLUSR>CURRENT 

e Directory SYSLIB1 is contained on volume VOLI 

e Directory SYSLIB2 is contained on volume VOL2 

e The system root volume is volume ZSYS51 

e The account of the task group using the macro preprocessor is PROJL6 
Given these assumptions, the statement 

LIBM EXEC_LIB 


_ initiates a search for the following directories in the order indicated. 
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LIBM 


Search Rule Number 1 | 

1. Search is for: \WOLUSR>CURRENT>EXEC _LIB 

Search Rule Number 2 

2. Search is for: \ZSYS51>UDD>PROJL6>MACRO>EXEC_LIB 
Search Rules Number 3 | 

3. Search is for: \VOL1>LDD>MACRO>EXEC_LIB 

4. Search is for: \VOL2>LDD>MACRO>EXEC_LIB 
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INCLUDE 


INCLUDE MACRO CONTROL STATEMENT 


The INCLUDE statement specifies that the contents of the named file be processed by the 
Macro Preprocessor as part of the unexpanded source input program. | 


The include file may contain any source statements normally appearing within the 
unexpanded source input program, with the following exceptions: 


1. The include filé may not contain any % INCLUDE macro control statements. 


2. The include file may contain macro call statements only if they are within inline macro 


routines. 
Format: ear 
symbolic-name | | 
[AMoINCLUDEA f AYele...} | ; 


symbolic-name 
Name of a file. The following search rules are employed to locate the include file referenced 
by the symbolic-name: 


1. Thecurrent working directory is searched for a file of the name, symbolic-name.IN.A. If 
this file is found, that file is the file referenced in the INCLUDE statement. 


2. The directory >UDD>account>INCLUDE, if it exists, is searched for the file 
symbolic-name.IN.A. If this file is found, this is the file referenced in the INCLUDE 
statement. 


3. The directory >LDD>INCLUDE, if it exists, is searched for the file symbolic- 
name.IN.A. If this file is found, this is the file referenced in the INCLUDE statement. 


The volume(s) containing the system directories SYSLIB1 and SYSLIB2 are searched to 
find the >LDD>MACRO directory. It may require the Change System Directory com- 
mand to identify the pathname of SYSLIB1 and/or SYSLIB2. 


[Afefe...] 
Name of a file in the form of an ASCII string constant. If the value of the string constant is a 
simple name, then it is processed as a symbolic-name. 
If the value of the string constant is not a simple name,A.IN.A is appended to the string; then 
it is expanded to an absolute pathname, which is assumed to be the name of the desired 
include file. 


The semicolon shown in the above format is part of the INCLUDE statement’s syntax, it does not 
indicate. 


~The %INCLUDE statement is also used to insert macro routines from external files into the 
unexpanded source program as inline macro routines. 


Example of Search Rules for Locating an Include File 
This example of the search rules is based on the following assumptions. 

e The current working directory is “VOLUSR>CURRENT 

e Directory SYSLIB1 is contained on volume VOL1 

e Directory SYSLIB2 is contained on volume VOL2 

e The system root volume is volume ZSYS51 

e The account of the task group using the macro preprocessor is PROJL6 
Given these assumptions, the statement 

%INCLUDE SOURCES; 


initiates a search for the following files within the file system in the order indicated. 
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INCLUDE 


Search Rule Number 1 | | 

1. Search is for: \VOLUSR>CURRENT>SOURCES.IN.A 

Search Rule Number 2 

2. Search is for: A ZSYS51>UDD>PROJL6>INCLUDE>SOURCES.IN.A 
Search Rule Number 3 

3. Search is for: \VOL1>LDD>INCLUDE>SOURCES.IN.A 

4. Search is for: \ VOL2>LDD>INCLUDE>SOURCES.IN.A 
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MACRO CALLS 


A macro call is a statement that causes a specified macro routine to be included in the source 
program and optionally assigns or reassigns values to parameters in that macro routine. The 
macro routine is included in the expanded source program at the location of the macro call. 

If a parameter is assigned a value only in the macro call or in both the macro call and the MAC 
statement, the value in the macro call is used. If a parameter is not assigned a value in the macro 
call but it was assigned a value in the MAC statement, that value is used. If it was not assigned a 
value in either location, its default value is a null character string. (See “Initialized Values of 
Macro Variables” at the end of this section.) 


If no parameter values are present in a macro call, the macro-name must be the last entry on 
the source line, or it must be immediately followed by a comma and an optional comment. 


Format: 
[label]Amacro-name | A[P,-value | [ value] | oa 


label 
Symbolic name that identifies the macro call. 
macro-name 


Name of the macro routine to be included in the expanded source module: this name must 
correspond to a name designated in a MAC macro control statement. 


P-value 
Value of macro parameter; can be any alphanumeric characters (see “Designating Al- 
phanumeric Values” at the end of this section). | 


In a macro call, parameters are positional; i.e., their values must be specified so that they 
correspond to parameters P1 to P9 and PA to PZ. A comma must be specified for each 
parameter whose value is not specified. All parameters beyond the last specified 
parameter’s value are considered to be omitted. 
Note: | 
It may be impossible to specify all parameter values on one source line. Parameter 
values can be continued on the next line by replacing the last comma with a 
semicolon. (See “Assembly Language Source Statement Formats” in 
Section 3.) 


Example: 


This example illustrates an unexpanded source program in which parameters are assigned 
values only ina MAC statement, only in a macro call, and in both a MAC statement and a macro 
call. The resulting expanded source program illustrates the inclusion of the macro routine and 
the appropriate parameter values. This example also illustrates the use of a parameter whose 
value is a null character string. 
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Unexpanded source module: 


TITLE MCL 


SAMPLE MAC P3=1,P5=8 Designates beginning of macro routine 
and assigns values to parameters P3 


and P5 
DC ?P3,?P2 
* NEWB ?P5 


-FINI ENDM Designates end of macro routine 


NUVAL SAMP LE ,2,,,5’,,5 Macro call that assigns value to parameter 
P2, and assigns different value to parameter 
P5; i.e., P2 equals 2 and P5 equals 5’,’5 


Expanded source module: 


TITLE MCL 

DC 1,2 First parameter value was assigned in . 
MAC statement; second parameter value 
was assigned in macro call 

* NEWB 5’,'5 Since different values were assigned to 
P5 in the MAC statement and in the macro 
call, the value in the macro call is used 
NESTED MACRO CALL 


A nested macro call is a macro call that occurs within a macro routine. Whenever a nested 
macro call is encountered, processing of the current macro routine stops; i.e., all of its macro 
parameters are saved, and the nested macro call is processed. The nested macro call has its own 
macro parameters. After the nested macro call and the macro routine named in the nested call 
are processed, processing of the previous macro routine resumes at the point of termination. 


Macro calls may be nested to as many levels as memory permits. Each level consists of one 
macro routine that calls another. For example, if macro routine A contains a macro call to macro 
routine B, one level of nesting exists. Ifmacro routine B contains a macro call to macro routine C, 
two levels of nesting exist. | 


Example: 


This example illustrates an unexpanded source module that contains a nested macro call and 
the resulting expanded source module. 
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Unexpanded Source Module 


TITLE NSTD 
MACRO1 MAC 

NEWA 

NEWB 

ENDM 
MACRO2 MAC 

NEWX 

NEWY 

MACRO1 Nested macro call 

NEWZ 

ENDM 


MACRO2 Macro call 


Expanded Source Module 


TITLE NSTD 


NEWX 
NEWY 


neue Contents of nested macro cal} 


NEWZ 


RECURSIVE MACRO CALLS 


A recursive macro call is a nested macro call that calls either the routine within which the call 
is located or another routine in the nest that eventually calls the original routine. A recursive 
macro call must be designed to reach its ENDM statement exactly once per call to it. Each time 
an ENDM statement is processed, the innermost level of recursion is terminated. An example of 
a recursive call is the case in which a macro routine processes parameter 1 and then if parameter 
2 is present, calls itself with ?P2 for parameter 1, ?P3 for parameter 2, etc.; that is, each 
parameter has been shifted one position left. A recursive macro call is processed the same as any 
other nested macro call. The depth of recursion is limited only by the amount of memory 
available to the Macro Preprocessor. 


CONTROLLING EXPANSIONS 


When a macro call requests a given macro routine, it need not always result in the same 
expansion. Values in that routine may vary, and the statements to be included in the source 


program may vary. This flexibility : is accomplished by including macro variables and peongs: 
tional macro control statements in the macro routine. , 


MACRO VARIABLES 


There are two types of macro variables: local and global. A local variable can be assigned a 
value only in a macro routine. A global variable can be assigned a value anywhere in the source 
module; e.g., in a macro routine in the source module, or in statements that constitute the body 
of the source module. | 


Variables have fixed names; only their values can be altered. Global variables are named G1 
to G9 and GA to GZ. Local variables are named L1 to L9.and LA to LZ. (The lowercase letters are 
considered to be equivalent to the corresponding uppercase letters.) To designate in a macro 
routine that substitution of a macro variable will occur, precede each variable name with a 
_ substitution operator, “?” (question mark); e.g., ?G1. When the macro routine is processed, the 
Macro Preprocessor will replace each reference to a variable with its value. 
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SETA 


A variable can be assigned an alphanumeric or numeric value by specifying the SETA or 
SETN macro control statement, respectively. 


Ifa variable is never assigned a value, its initial value is used as the default. (See “Initialized 
Values of Macro Variables” at the end of this section.) 


The values assigned to global variables are available for use by all macro routines. The values 
assigned to local variables are available for use only by the macro routine which assigned them. 
In the case of nested or recursive macro calls, each time a macro routine is called, it has a new set 
of local variables to use. When the nested or recursive macro routine is complete, the previous 
values assigned by the outer macro are restored to the local variables. 


MACRO SUBSTITUTION 


Macro substitution allows a character string contained in the macro prototype to be replaced 
by another character string that is derived from the contents of the macro parameters and/or 
macro variables. By this substitution, a generalized macro prototype can be specialized to 
produce different expansions depending on the arguments present in the various calls. 


Substitution of macro parameters and variables, and evaluation and substitution of macro 
functions are the first operations performed upon a macro prototype during a macro expansion. 
Thus, macro control statements can be generalized in the same manner as any other statement 
in the macro prototype. 


The substitution operator, “?”, is used in the macro prototype to indicate where substitutions 
are to occur when the macro is expanded. The substitution operator must be followed by the 
name of a macro parameter, the name of a macro variable, or a macro function reference. 


When the macro processor encounters a substitution operator followed by a macro parameter 
name or a macro variable name, the substitution operator and the name following are replaced 
by the value of the referenced parameter or variable. When a substitution operator followed by a 
macro function reference is encountered, the function is evaluated and then the substitution 
operator and function reference following it are replaced by the value returned by the function. 


After substitution is completed, the replacement value is rescanned. 


The occurrence of a function reference may be represented in whole or in part by a “nested” 
substitution operation. In this case the inner substitution operation is performed before the 
outer substitution operation. Substitution operations may be nested to any depth. 
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SETA / SETN 


SETA MACRO CONTROL STATEMENT 


The set alphanumeric macro control (SETA) statement assigns an alphanumeric value to a 
local or global macro variable. If you assign a value to a variable and then redefine the variable 
in a subsequent SETA or SETN statement, the last value specified is used.” 


When assigning a value to a global macro variable, you can specify SETA anywhere within 
the source module. When assigning a value to a local macro variable, you must specify SETA in 
the macro routine in which the variable is referenced. 


Format: 
variableASETAAvalue 
variable 


Name of the local or global macro variable that is being assigned a value; must be L1 to LY, 


LA to LZ, G1 to G9, or GA to GZ (The lower case letters are considered to be equivalent to the 
corresponding uppercase letters.) 


value 


Must be alphanumeric. (See “Designating Alphanumeric Values” at the end of this section.) 


Example: 

This example illustrates an unexpanded source program in which macro variables are assigned 
values in SETA statements. The resulting expanded source program includes those macro 
variable values. 


Unexpanded source program: 


SETA EXAMPLE 


TITLE VALUE 
EXAMPLE MAC Designates beginning of macro routine 
L4 SETA DE Assigns alphanumeric value to L4 
L5 SETA ’'X’” Assigns alphanumeric value to L5 
L4 SETA (5+6* 2) Assigns different alphanumeric value to L4 
G6 SETA "" Assigns alphanumeric value to G6 
DC NOT?L4 
TEXT ?L5 


DC 1?G62?G63 


ENDM Designates end of macro routine 
SAMPLE Macro Call 


Expanded Source Module: 


TITLE VALUE 


DC NOT (5+6* 2) Least value for L4 is used; note that numeric 
| expression is not evaluated 
TEXT ‘xX’ Embedded double apostrophes become single apostrophes 


DC 1,2,3 Comma inside quote strings are data 


*When a nested macro call is encountered, values of local variables and parameters in the current macro routine are 
saved and are still applicable after the nested macro call is processed. 
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SETN 


SETN MACRO CONTROL STATEMENT 


The set numeric macro control (SETN) statement assigns a numeric value to a local or global 
macro variable. The assigned value is the ASCII representation of the decimal equivalent of the 
specified numeric value. If you assign a value to a variable and then redefine the variable in a 
subsequent SETN or SETA statement, the last value specified is used. * 


When assigning a value to a global macro variable, you can specify SETN anywhere within 


the source program. When assigning a value to a local macro variable, you must specify SETN i in 
a macro routine. 


Format: 
variableASETNAvalue 


variable 


Name of the local or global macro variable that is being assigned a numeric value; must be L1 
to LY, LA to LZ, G1 to GY, or GA to GZ (The lowercase letters are considered to be equivalent 
to the corresponding uppercase letters.) 


value 


Must be numeric. (See “Designating Numeric Values” at the end of this section.) 
Corresponds to internal value expression which is defined in Section 2. 


The operand of the SETN statement begins at the first character after the operation code that 
is neither a blank nor a horizontal tab. The operand terminates at the end of the statement or at 
_ the first blank or horizontal tab not within apostrophes after the beginning of the operand. For 
example: 


GLASETNA22+8 assigns the value 30 in unpacked decimal representation (3330 in 
| hexadecimal) to the global variable GL. 
GAASETNA6+‘A0’ assigns the value A6 (2036 in hexadecimal) to the global variable GA. 
G6ASETNA-— X°F’ assigns the value — 15 (2D3135 in hexadecimal) to the global variable 
G6 
Example: 


This example illustrates an unexpanded source module in which macro variables are assigned 
values in SETN statements.. The rm suiine expanded source module includes those macro 
variable values. 


Unexpanded source module: 


TITLE EXMPL 
SAMPLE MAC Designates beginning of macro routine 
L5 SETN 3 Assigns numeric value to L5 
L6 ao a (?7L5*?G2)+1 Assigns numeric value to L6; expression is evaluated 
FINI ENDM Designates end of macro routine 
G2 SETN 2 _ Assigns value to G2 


SAMPLE Macro call 


Expanded source module: 
TITLE EXMPL 


DC 13 


3When a nested macro call is encountered, values of local variables and parameters in the current macro routine are 
saved and are still applicable after the nested macro call is processed. 
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CONDITIONAL MACRO CONTROL STATEMENTS 


These statements allow the subsequent processing to be varied according to the conditions 


that exist when the statement is executed. 


Conditional macro control statements are listed and described below: 


FAIL 
GOTO 
IF 
NULL 


FAIL MACRO CONTROL STATEMENT 


The FAIL statement is used to ensure that conditions are logically consistent; it does not affect 
expansions. The Macro Preprocessor issues a Z error flag for each FAIL statement. 


Format: 


(label JAF AIL 


label | 
Symbolic name that identifies FAIL statement. 


Note: 


If an assembly control FAIL statement is desired within a macro routine, it must 
be protected. 
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GOTO 


GOTO MACRO CONTROL STATEMENT 


The GOTO statement causes the Macro Preprocessor to stop processing the macro routine or 
to resume processing at a specified statement. The statement at which processing will resume 
can be in any location within the macro routine; i.e., it need not be subsequent to the GOTO 


statement. 
Format: 

. | 
label ]JAGOTOA | ainda 
label 


Symbolic name that identifies the GOTO statement. 


Causes Macro Preprocessor to stop processing the macro routine; i.e., the current line is 
considered an ENDM macro control statement. Processing resumes at the statement that 
follows the current macro call. 


skip-label 


Symbolic name of statement within the macro routine at which Macro Preprocessor should 
resume processing. If a macro routine contains more than one statement whose symbolic 
name is skip-label, processing resumes at the first occurrence of such a statement after the 
MAC statement. 
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IF MACRO CONTROL STATEMENT 


The IF statement causes the Macro Preprocessor to evaluate characters in either one or two 
operands to determine if a specified condition exists. If the condition exists, the Macro 
Preprocessor stops processing the macro routine or resumes processing at a specified statement 
that is subsequent to the IF statement. If the condition does not exist, the next sequential 
statement is processed. 


Format 1. 


Evaluating characters in one numeric operand: 


f 
[N] 4N - 
[label JAIF Z) 7 Aoperand, sip tet 
OD 
EV 
label 
Symbolic name that identifies the IF statement. 
[N]P 
(Not positive (i.e., positive is > 0, not positive is < 0)) 
[NIN 
(Not negative (i.e., negative is > 0, not negative is = 0)) 
[N]Z 
(Not) zero. 
OD 
Odd. 
EV 
Even. 
operand 


Character(s) being evaluated; must be numeric. (See “Designating Numeric Values” at the 
end of this section.) Corresponds to internal value expression, which is defined in Section 2. 


If condition in IF statement is true, causes Macro Preprocessor to stop processing macro 
routine; i.e., the current line is considered an ENDM macro control statement. Processing 
resumes at the statement that follows the current macro call. 


skip-label 


If condition in IF statement is true, designates symbolic name of statement at which Macro 
Preprocessor should resume processing. If a macro routine contains more than one statement 
subsequent to the IF statement, whose symbolic name is skip-label, processing resumes at 
the first occurrence of such a statement after the IF statement. 


Format 2. 
Comparing characters in two alphanumeric operands: 


G * | 
[label JAIF [N] [| Aoperand ,, operand abl 
E} | 


label 
Symbolic name that identifies the IF statement. 
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IF 


[NIG 
(Not) greater than. 


[NL 
(Not) less than. 


[N]E 
(Not) equal to. 
operand , , operand, 


Character strings being compared; must be alphanumeric. (See “Designating 
Alphanumeric Values” at the end of this section.) | 


Starting with the leftmost character, the Macro Preprocessor compares each character in 
operand, to the character in the corresponding position in operand ,. The characters are 
compared until either a pair of unequal characters is encountered, or all of the characters 
have been compared. If the operands are different lengths, the rightmost characters of the 
shorter operand are considered to be ASCII blanks. (Table 2-2 describes the hexadecimal 
values of ASCII characters.) 


The unequal characters are compared according to the ASCII collating sequence to 
determine the algebraic relationship between the two operands. 


If the condition specified in the IF statement is true, causes Macro Preprocessor to stop 
processing macro routine; i.e., the current line is considered an ENDM macro control 
statement. Processing resumes at the statement that follows the current macro call. 


skip-label 
If condition in IF is true, designates symbolic name of statement at which Macro Preproces- Hh. 
sor should resume processing. 


If a macro routine contains more than one statement subsequent to the IF statement whose 
symbolic name is skip-label, processing resumes at the first occurrence of such a statement 
after the IF statement. | 


NOTE: 
If an assembly control IF statement is desired within a macro routine, it must be 
protected. 


Example 1. Evaluating characters in one numeric operand: 


Unexpanded Source Module: 


TITLE CONDL 


G5 SETN 1 
BGN MAC 
Cie TAG1  Conditionalize the macro expansion via value of G5 
FAIL 
TAG1 DC 1 


IE EV fod TAG2 Conditionalize the macro expansion via value of G5 
FAIL 
TAG2 DC 1 


FINI ENDM 


BGN Macro call 
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IF 


Expanded Source Module: 


TITLE CONDL 


: FAIL statement is not produced 
TAG1 DC 1 


FAIL FAIL statement for Assembler is produced 
TAG2 “DC 1 


Example 2. Comparing characters in two alphanumeric operands: 
Unexpanded Source Module: 


TITLE TWO 
INCL MAC 


IFE AB,AB,TAG1 Conditionalize the macro expansion 
[FAIL] 
TAG1 DC 1 


IFE AB.CD,TAG1 
[FAIL] 
TAG1 DC 1 


FINI ENDM 


INCL 


Expanded Source Module: 


TITLE TWO 
FAIL statement is not produced 
TAG1 DC 1 
FAI L FAIL statement for Assembler is produced 


TAG1 DC 1 
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NULL MACRO CONTROL STATEMENT 


The NULL statement has no effect on the processing of macro routines. Processing continues 
with the next sequential instruction. 
This statement is often used to define a label referenced by an IF or GOTO statement. 


Format: 
[label JANULL 
label 
Name of the label being defined. 
Note: 


If an assembly control NULL statement is desired within a macro routine, it must 
be protected. 
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MACRO FUNCTIONS 


Macro functions have the following capabilities: 

e Determine number of characters that are in a specified character string (AL function) 
e Convert a numeric value to its hexadecimal equivalent (CH function) 

e Search a character string for an embedded character string (IX function) 


e Determine which character within a character string is the first character that is the first 
character of another character string (SR function) 


e Specify which characters within a character string should be included in the source 
statement (SS function) 


e Permit parameters and variables to be referenced by their ordinal positions (V function) 


e Determine which character within a character string is the first character that is not in 
another character string (VR function) 


e Determine what type of constant makes up a character string (AT) 
e Translate a character string from one code set to another code set (TR) 


Macro functions can be specified in any location(s) of statements in macro routines. Within 
‘one statement there can be multiple macro functions; these functions can be nested. Nested 
macro functions are processed from the innermost function to the outermost function. 


FORMAT OF MACRO FUNCTIONS 


Macro functions are described alphabetically on the subsequent pages. As indicated in their 
formats, each function is preceded by a substitution operator, “?” (question mark) and its 
arguments are enclosed within one set of parentheses. Functions require that you specify either 
a numeric or an alphanumeric value. Methods of specifying these values are described at the end 
of this section under “Designating Numeric Values” and “Designating Alphanumeric Values.” 


Substitution of macro parameters and variables, and evaluation and substitution of macro 
functions are the first operations performed upon a macro prototype during a macro expansion. 
Thus, macro control statements can be generalized in the same manner as any other statement . 
in the macro prototype. ¥ 


Macro functions require one, two, or (optionally) three arguments. 


LENGTH ATTRIBUTE MACRO FUNCTION 


The length attribute (AL) function causes the Macro Preprocessor to designate the number of 
characters that are in a specified character string. If a null character string is specified, the 
AL function evaluates to zero. 

Format: 
°AL(arg) 
arg 
Character string whose length is to be determined; must be alphanumeric. (See “Designat- 
ing Alphanumeric Values,” at the end of this section.) 
Example: | 
2?AL(?L5+?P5) 


If variable L5 equals 2AB, and parameter P5 equals 5B, the above function will be replaced with 
6. 
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AT 


TYPE ATTRIBUTE MACRO FUNCTION 


The type attribute macro function inspects a character string and returns a code letter that 
indicates the type of data that makes up the inspected string. The code letters and the associated 
data types are as follows. | 


Code Letter Data Type 


A ASCII string constant 
B Bit string constant 
D Double precision floating point constant 
E Single precision floating point constant 
F Short fixed point constant 
I Binary integer constant in decimal notation 
L Long fixed point constant 
N Null string 
P Packed decimal constant 
U Unpacked decimal constant 
X Binary integer constant in hexadecimal notation 
Z Hexadecimal string constant 
O Other than the above 

Format: 

?AT(arg) 
arg 


Character string to be inspected. 
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CH 


HEXADECIMAL CONVERSION MACRO FUNCTION 


The hexadecimal conversion (CH) function converts a numeric argument to its hexadecimal 
equivalent. 


Format: 
?CH(arg ,[,arg 2]) 
are 1 


Value to be converted to hexadecimal; must be numeric. (See “Designating Numeric Val- 
ues,” at the end of this section.) 


The numeric expression defining the value of arg is allowed to define a 32-bit signed integer; 
i.e., —231 =< arg, < 231 must be satisfied. 


arg 2 


Value that specifies the format of the hexadecimal representation, as described below; must 
be numeric. (See “Designating Numeric Values,” at the end of this section.) 


Value of arg » Meaning 


Not Specified The value returned is a character string containing the source 
language representation of a binary integer constant in 
hexadecimal notation, with no insignificant zeros, having the 
same value as arg.. 

0 Arg, is converted to a 32-bit signed twos-complement binary 
integer. This binary integer is then treated as if it were an 
8-digit unsigned hexadecimal integer. The value returned is the 
character string representation of the significant digits of the 
unsigned hexadecimal integer. 

>0 The value returned is a character string containing the source 
language representation of a binary integer constant in 
hexadecimal notation, specifying min(arg,,4) digits, having the 
same value as arg,. When this format is used, the conditions 

—2min(4*arg,—1,15)<arg,<2min(4* arg,—1,15) 
must be satisfied. 

<0 The value returned is the same as described for arg, equal to 
zero, except that it is returned with min(—arg,,8) digits. 


Examples: 
Function 
Condition Specified Result 
arg , not specified ?CH(10) X’A’ 
arg, =0 ?CH(10,0) A 
arg, >0 ?CH(10,1) X’A’ 


?CH(10,2) X’0A’ 
?CH(10,3) X’00A’ 
?CH(10,4) X’000A’ 
?CH(10,6) X’000A’ 
arg. <0 ?CH(10,-1) A 
?CH(10,-2) OA 
?CH(10,-3) OA 
?CH(10,-4) 000A 
?CH(10,—6)  O0000A 
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INDEX MACRO FUNCTION 


The index (IX) function causes the Macro Preprocessor to search a specified character string 

for the occurrence of an embedded character string. 

Format: 
?1X(arg ,,arg >) 

arg 1 | 
Character string being searched, must be alphanumeric. (See “Designating Alphanumeric 
Values” at the end of this section.) 

arg 
Embedded character string for which the Macro Preprocessor will search; must be 
alphanumeric. 


The value returned specifies the character position within arg , of the first (leftmost) character 
of the embedded character string. If arg . is not contained within arg , or arg , is a null character 
string (e.g.,”), a zero is returned. 

Example: 
?TX(ABCDE5,CDES) 
The above function reference causes the Macro Preprocessor to search ABCDE5 for the 


character string CDE5. Since the embedded character string starts in the third character 
position of ABCDE5, the Macro Preprocessor replaces the index function reference with a 3. 
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SR 


SEARCH MACRO FUNCTION 


The search (SR) function causes the Macro Preprocessor to determine which character of a 
specified character string is the first (leftmost) character that is also in another specified 
character string. 


Format: 
?SR(arg ,,arg 2) 
arg ; 


String of characters from which one character at a time is selected from left to right, and 
compared to every character in arg,, from left to right, until a match is found; must be 
alphanumeric. (See “Designating Alphanumeric Values” at the end of this section.) 


arg o 


String of characters controlling the search; i.e., this argument specifies those characters 
that, if matched by a character of arg, satisfy the search; must be alphanumeric. (See 
“Designating Alphanumeric Values” at the end of this section.) 


The search proceeds as follows. The leftmost character in arg , is compared with each character 
in arg . proceeding from left to right. Ifa match is found, the value of the function is 1, indicating 
that the leftmost character of arg ,is also in arg 5. Ifno match is found, the second character is 
compared, etc. In general, the value of the function is the ordinal position of the leftmost 
character of arg, that is also a character within arg... 

Ifnone of the characters in arg , are found inarg ,, orifarg ,or arg ,isa null string, the value of 
the function is 0. 


Example 1: 
?SR(CHARSUBSTRING,STRING) 


The above macro function reference causes the Macro Preprocessor to determine the leftmost 
character of CHARSUBSTRING that is also in STRING. Since the character R is the leftmost 
character of CHARSUBSTRING that is also in STRING and it is in the fourth character position 
of CHARSUBSTRING, the macro function is replaced with 4. 


Example 2: 
2SR(FAB2,’BCAT’) 


The above macro function reference causes the Macro Preprocessor to determine the leftmost 
character of FAB2 that is also in BCA1. Since A is the leftmost character in FAB2 that is also in 
BCAI, and it is in the second character position of FAB2, the macro function reference is 
replaced with 2. 


Example 3: 
2SR(BA3,?L1) 


The above macro function reference causes the Macro Preprocessor to determine the leftmost 
character of BA3 that is also in local variable 1. If L1 equals 23A, A is the first character that is 
also in L1. Since A is in the second character position of BA3, the macro function reference is 
replaced with 2. 
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SUBSTRING MACRO FUNCTION 


The substring (SS) function causes the Macro Preprocessor to include in the source statement 
a specified number of characters of a specified character string, beginning with the character 
that is in a specified character position. 


Format: 
?SS(arg 1, arg » arg, ]) 
arg i 


Character string that contains the characters to be included in the source statement; must 
be alphanumeric. (See “Designating Alphanumeric Values,” at the end of this section.) 


arg 2 


Character position of the first character is arg : that is to be included; must be numeric. (See 


“Designating Alphanumeric Values,” at the end of this section.) 

arg 3 
Number of characters to be included; must be numeric. (See “Designating Alphanumeric 
Values,” at the end of this section.) 


Default: The character whose character position was specified in arg », and all subsequent 
characters of arg ,. 


If arg ,isanull character string, or if arg, is <0, or ifthe value specified in arg, is greater than 
the length of arg,, a null character string is included in the source statement. 
Example 1: 
?2SS(?P2,?L5,3) 
If P2=ABCDE and L5=2, the above function reference designates that the source statement 


include three characters of ABCDE, starting with the character in the second character position. 
BCD would be included. 


Example 2 
2SS(?P2,?L5) 
If P2=ABCDE and L5=2, the above function reference designates that the source statement 


include all characters of ABCDE, starting with the character in the second character position. 
BCDE would be included. 


Example 3: 


G6 SETA ?SS’ABAC?5’,4 yields 
G6 SETA C?5, which defines G6 to be the character string C?5. 
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TRANSLATE MACRO FUNCTION 


The translate macro function translates an alphanumeric character string from one code set 
to another. The translation proceeds as follows. The string specified by arg , is processed from left 
to right character by character. The arg , character is compared with the characters in the string 
specified by arg,. The first time a match occurs, the ordinal position in the arg, string is noted, 
and the character in the same ordinal position in arg, is moved to the result. Ifno match occurs, 
the arg, character is moved to the result; i.e., no translation. Thus, the result is an alphanumeric 
string of the same length as that of arg, . 


Format: 
? TR(arg ,,arg 2, [arg 3]) 


arg ; 
The input string; i.e., the string to be translated. Must be alphanumeric; (See “Designating 
Alphanumeric Values” at the end of this section.) 


arg » 
The string consisting of the code set from which the characters of the result are selected (if a 
translation occurs). Must be alphanumeric; (See “Designating Alphanumeric Values” at the 
end of this section.) If the character string specified by arg’, is shorter than that of the 
character string specified by arg,, arg, is padded on the right with spaces until it is the same 
length as arg,. 


arg 3 
The string consisting of the code set to which the characters of the input string are matched. 
Must be alphanumeric; (See “Designating Alphanumeric Values” at the end of this section.) 
If arg, is omitted, the ASCII code set (See Figure B-4) is used as arg,. 


Example: 


LXASETAA?TR(?P1, ABCDEFGHIJKLMNOPQRSTUVWXYZ’ ; 
| ‘abcdefghijklmnopqrstuvwxyz’) 


The macro control statement SETA assigns an alphanumeric value to local macro variable X. 
The value assigned (the result of the Translate function) is an alphanumeric string that is the 
same as the alphanumeric string specified by P1 except that each lowercase letter is changed to 
the corresponding uppercase letter. The results of the translation for various strings specified by 


P1 are shown below. 


Pi 

axes AXES 
Man2 MAN2 
3-al2 3-A12 


New York NEW YORK 
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VECTOR ORIENTATION MACRO FUNCTION 


The vector orientation (V) functions permits macro parameters and macro variables to be ‘eS 
referenced by their ordinal positions rather than by their names. 


Format: 


P 
2?V 7L (arg) 
G 


Parameter 


P 


L 

Local variable. 
G 

Global variable. 
arg 


Value that identifies a parameter or variable; must be from 1 to 35; 1 identifies the first 
parameter or variable, 2 the second, etc.; must be numeric. (See “Designating Numeric 
Values” at the end of this section.) 


Example: 
2SS(?V P(10),2,3) 
The above function illustrates usage of the vector orientation function within a substring (SS) 


function. The function reference ?VP(10) identifies parameter PA. If PA = ABCDE, the above 
substring function reference is replaced with BCD. 
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VERIFY MACRO FUNCTION 


( The verify (VR) function causes the Macro Preprocessor to determine which character of a 
: specified character string is the first (leftmost) character that is not in another specified 
character string. 


Format: 
?VR(arg ,,arg >) 
arg ; 


String of characters from which one character at a time is selected, from left to right, and 
compared to every character in arg,, from left to right, until no match is found; must be 
alphanumeric. (See “Designating Alphanumeric Values” at the end of this section.) 


arg » 
String of characters controlling the search; i.e., this argument specifies those characters 


that, if unmatched by a character of arg,, satisfy the search; must be alphanumeric. (See 
“Designating Alphanumeric Values” at the end of this section.) 


The verification proceeds as follows. The leftmost character in arg , is compared with each 
character in arg . proceeding from left to right. If no match is found, the value of the function is 1, 
indicating that the leftmost character of arg , is not also in arg ,. If a match is found, the second 
character is compared, etc. In general, the value of the function is the ordinal position of the 
leftmost character of arg, that is not a character within arg,,. 

If all the characters in arg , are found in arg ,, orifarg , isa null string, the value of the function 
reference is 0. 

Example 1: 
?VR(STRINGSUBSTRING,STRINGCHARSTRING) 


( The above macro function causes the Macro Preprocessor to specify the leftmost character in 
| STRINGSUBSTRING that is not in STRINGCHARSTRING. Since U is the leftmost character 
in STRINGSUBSTRING that is not in STRINGCHARSTRING and it is in the eighth character 
position of STRINGSUBSTRING, the Macro Preprocessor replaces the function reference with 
8. | 
Example 2: 

?VR(?P3,?G5) 
If parameter P3 has a value of ABC3D, and global variable G5 has a value of AD3, the first 
character of P3 that is not in G5 is B, the second character of P3. Therefore, the Macro 
Preprocessor replaces the function reference with a 2. 


EXAMPLE ILLUSTRATING MACRO FACILITY 


Figure 8-1 illustrates a sample unexpanded source module and an Assembler listing of the 
resulting expanded source module. : 
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TIILe USEMAC 


x 

*INCLUDE IN@LINE MACKO ROUTINES, 

x 

POLY MAC 

*THIS MACKU GENERATES CODE TO CUMPUTE 
KYSXRKN + Xee( Ne] ) +. ewe + xX + Le 

*X 1S DESIGNATED BY PARAMETER 1, 

*Y IS DESIGNATED GY PARAMETER 2, 


*N IS DESIGNATED oY PARAMETER 3, 
* 


(*) 
| LOV dR1,1 
Ge SETN aP3 NUMBER UF FACTURS, 
TESTN iFzZ 2G2eSTUREX COMPLETE? 
(x) . 
FACTOR  ?P1 “NOse e NESTED CALL FUR ANOTHER FACTUR, 
(x) 
b2 SETN ?be-} DECREASE FACTOR COUNTER. 
GOTU TESTA 
STOREX STR drRis?P2 STORE POLYNUMIAL VALUE. 
ENOM 


x 
x 

FACTOR MAC 

* 

KTHIS MACRU GENERATES CODE WHICH MULTIPLIES ($R1) BY THE 
KCONTENTS UF THE LUCATION DESIGNATED BY PARAMETER 1, AND 
*ADOS 1 TO THE PRODUCT. 

* 


MUL SRL, ?P1 
ADV Rio 1 
ENDM 

x 

x 

MOVER MAC P4=Q 


x 

*THIS MACRO GENERATES CUVE WHICH PERFURMS A "MEMOKY TO MEMURY" 

*MOVE OF DATA, 

KIF PARAMETER 4 IS NOW@ZERO, THE CODE WILL MUVE BYTES. 

*IF PARAMETCR 4 IS ZERU, THE CODE WILL MUVE wURDS. (DEFAULT OPTION), 
*PARAMETER 1 SPECIFIES THE SOURCE ADDRESS, 

*PARAMETER 2 SPECIFIES THE DESTINATION aDDRESS, 

*PARAMETER 3 SPECIFIES THE NUMBER OF UNITS (BYTES OK WORUS) TU MOVE, 
* 


IFNZ 2?P4,6YTMOV BYTES OR wORDS? 
* 
*xMOVE WORDS eee 
LL SETA. LOR USE LOCAL VARIABLES TO DEFINE DESIRED OPCUDES. 
LS SETA STR 
GOTO SAME 
* 
*MOVE BYTES... 
BYTMUV NULL 
LL SETA LOn 
LS SETA STH 
x 
SAME NULL 
(*) 
(*] 
*USE VECTOR FUNCTION TO SUBSTITUTE PAKAMETERS. 
LAB S$B81,%vVP(1) 
LAtb $h2r,?VPC2) 
CL =$R1 
*NEXT STATEMENT wILkL MAVE A UNIGUE LABEL. 
NXT?L1 PLL $R3,$81.5R1 
?7LS bR3,$02.+8R1 
*GET UNIT COUNT AS A HEX INTEGER. 


CMR SR1,5?7CH(2VP(3)) 


, FOLLOWING NULL IS FUR Trt ASSEMBLER, 
(NULL ] 


ENDM 


MAKE USE OF THE IN@eLINE MACRO DEFINITIUNS DEFINED ABOVE. 


Figure 8-1. Sample Unexpanded Source Module and Assembler Listing of Resulting 
Expanded Source Module 
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x 
KEL ZRG LDV $R1i-e 


STR $R1>,X 

FOLY Xe Yr CUMPUTE YEXuxa5 eX ane XaasexaacexXed, FOR XE2, 
* 

MOVER Ar,6e/i11,-1 MUVE 11 6YTES FROM A TO b, 
* 

ALT 
x RESV 1 
Y RESV 1 
A RESV 20 
's) KESV 2u 

END USEMAC ,REL ZRO 


XASSEMBLER LISTING OF RESULTING EXPANDED SOURCE MODULE 


USEMAC ASSEMBLER-0110-05/01/1433 | PAGE 0001 
000001 TITLE USEMAC 
‘00000e * 

000003 *INCLUDE INeLINE MACRO ROUTINES. 
000004 * 
0009005 * 
000006 * 
000007 * 
000005 * 
000009 * 
000010 x . 
000011 *MAKE USE OF THE INeLINE MACRO DEFINITIONS DEFINED ABOVE. 
voOd01e x 
000013 Q0uU0 ic0e KEL ZRO LOV Rive 
000014 vu001 9Y%F4O OOIF STR SR1i,x 
000015 * 
000016 9005 icdl LOV $K1,1 
000017 x 
000018 Qvuv4 96840 001C MUL $ki,xX 
000019 0006 1£01 ADV Ski, 1 
v00020 * 
v000e1 x 
000022 0007 96840 0019 MUL Rix 
0000e€5 9009 1601 ADV SRi,l 
000U2e4 * 
000025 * 
000026 O00A 9840 0016 MUL SR1,X 
0000e7 VO00C 1601 ADV SR1,1 
000028 * . 
000029 * 
000030 Qv0d 95440 0015 MUL SR1,X 
000031 OOOF LE 01 ADV SK1,1 
00003e * 
000033 * 
000034 0010 9840 0010 MUL SR1,X 
000035 dO0i1e 1201 ADV $R1,1 
000036 * 
000037 v013 9F4O ODODE STOREX STR $R1,Y STORE POLYNUMIAL VALUE. 
0000 58 * 
000039 ® 
000040 x 
000041 0015 9b6C0 0000 LAt $61,A 
000042 Q017 ABCO QUIF LAG $B2,8 
000043 0019 8751 | CL =$Ri 
000044 Q01A 6091 NXT007 LDH $R3,%$81.$R1 
000045 001B B7DE STH $R3,$62.+$R1 
000046 001C 9970 0008 CMR $R1,2X'B! 
00G047 VOOlE 0902 BE >$+2 
000048 OO1F OF FB B >NXT007 
v00049 NULL 
000050 * 
000051 * 
000052 " 
000053 Q020 vu00 HLT 
000054 QvUel x ReSv i 
000055 Q022 Y RESV ] 
000056 0023 A RESV 20 
000057 4037 B RESV 20 


000058 0048 0000. | END USEMAC,RELZRO 
0000 ERR COUNT 


Figure 8-1 (cont). Sample Expanded Source Module and Assembler Listing of Resulting 


Expanded Source Module 
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PROGRAMMING CONSIDERATIONS 


1; 


3. 


If an expanded source program, each macro control statement and each other type of 
statement that contains error flag(s) can comprise up to 249 characters. Each other line 
can comprise up to 255 characters. Subsequent characters are truncated. 


Input to the Macro Preprocessor may be either uppercase or lowercase characters. All 
lowercase characters in ASCII and hexadecimal string constants, and in hexadecimal 
integer constants remain lowercase characters; all other lowercase characters within the 
source module are converted to uppercase. 


If insufficient memory exists, memory can be conserved by: 

Assigning some or all macro routines to macro libraries. 

Limiting the level of nested macro calls. 

Limiting the size of macro parameter and variable values. 

Specifying in LIBM macro control statements only those macro routines that will 
actually be requested in subsequent macro calls. 


Boop 


INITIALIZED VALUES OF MACRO VARIABLES 


Each local macro variable is initialized to be a null ASCII character string, except for the 
following: ; 


L1 


L2 


L3 


L4 


Unique 3-character string. Each time there is a macro call, the value of L1 is incremented by 
1; can be from 001 to ZZZ (i.e., 001,002,...,009,00A,...,.00Y,00Z,010,011,...,ZZZ). This variable 
permits a statement in a macro routine to have a unique label each time the routine is 
requested in a macro call; e.g., if the label of a statement is ?G1?L1SM, the label would be 
$001SM the first time the routine is requested, and $002SM the second time the routine is 
requested if no other routines were requested in between the two requests and also assuming 
the initial value of G1 has not been altered. 


It is recommended that labels generated by macro routines be of the form ?G1?L1xx where xx 
are any two characters that are unique within a given expansion of a given macro routine. It 
is further assumed that the global macro variable G1 contains a single character that will 
not be used as the first character of any label, except for those labels generated in a macro 
expansion. 


Numeric value that designates the current level of macro call nesting in the current macro 
call. If the macro call is not a nested macro call, L2 equals 0. 


Numeric value that designates the ordinal number of the last parameter that was assigned 
a value in the current macro call. If the macro call does not include any parameters, L3 
equals 0. 


Label of the current macro call. If no label is specified, L4 equals a null character string. 


Global macro variable G1 is initialized to equal $. Global macro variable G2 is initialized to a 
16 character string whose value reflects the contents of the External Switch Word at the time 
the macro processor was initiated. The first character of G2 will be the character “0” if external 
switch 0 was off, or the character 1 if external switch 0 was on; the second character of G2 will be 
a 0 or 1 depending on whether external switch 1 was off or on respectively; etc. Each other global 
variable is a null character string. These values remain in effect unless they are reassigned in 
SETA or SETN macro control statements. 


G1 


Global macro variable, initialized to equal $. 
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G2 
Global macro variable, initialized to a 16-character string. This value reflects the contents of 
the External Switch Word at the time the macro processor was initiated. The first character 
of G2 will be the character “0” ifexternal switch 0 was of, or the character 1 ifexternal switch 
O was on; the second character of G2 will be a 0 or 1, depending on whether external switch 1 
was off or on, respectively; etc. 

G3-G9, GA-GZ 
Each of these global variables is a null character string. 

NOTE: The above global variable values remain in effect until they are reassigned in SETA or 

SETN macro control statements. | 


DESIGNATING NUMERIC VALUES 


When an operand or argument requires a numeric value, the value must be from — 32768 to 
+32767}. (See “Truncation/Padding of String Constants” in Section 2 to determine how charac- 
ters are truncated, if necessary.) A numeric value can be specified as follows: 

e Binary integer constant in decimal notation (e.g., 31764, +4652) 

e Binary integer constant in hexadecimal notation (e.g., +: X’2F’,X’7000’) 


e Substitution operator followed by macro variable name whose contents are the source 
language representation of a binary integer constant in decimal or hexadecimal notation 
(e.g., ?G3, ?L4) 

e The hexadecimal conversion function, CH, allows the numeric expression which defines 
the first argument to evaluate a 2-word signed integer value. 

e Substitution operator followed by macro parameter name whose contents are the source 
language representation of a decimal or hexadecimal integer constant (e.g., ?P2) 


e Substitution operator followed by a macro function that returns a numeric value 

e Expression that combines any of the above character strings by including arithmetic 
operators (e.g., 31764+(?G3)) (See “Expressions” in Section 2.) 

e Assembler functions (See “Expressions” in Section 2.) 


DESIGNATING ALPHANUMERIC VALUES 


When an operand or argument requires an alphanumeric value, you can specify any type of 
alphanumeric character string, including the following: 


e A character string that does not contain a space, horizontal tab, comma, semi-colon, 
apostrophe, left or right parenthesis 


e An ASCII string constant (which must not be preceded by the optional letter ‘A’) 
e Substitution operator followed by macro variable name 

e Substitution operator followed by macro parameter name 

e Substitution operator followed by macro function | 


e Expression that combines any of the above character strings by specifying them adjacent 
to each other or encloses an individual or concatenated string within balanced paren- 
theses. | 

An alphanumeric value is terminated by a space, a horizontal tab, comma, semi-colon, 

unbalanced right parenthesis, or end of line, according to the system rules of the statement or 
function in which it appears. 


Each ASCII string constant in an alphanumeric value is converted to the length delimited 
internal form by first replacing each unprotected substitution operator and following macro 
parameter or variable name by the content of that parameter or variable and replacing each 
unprotected substitution operator and following macro function reference by the value returned 
by that function. After all substitutions have been completed, the delimiting apostrophes are 
removed and any embedded apostrophe representations are reduced to a single character each. 
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Example: 
2SSCVABC”DEF”’GH’,4,5) 


In this example, the first argument of the substring function evaluates to the character string 
ABC’DEF’GH. The resultant substring (i.e., five characters, beginning at the fourth character) 
is DEF’. , | 

_ NOTE: The arguments of a macro call statement and the arguments of a MAC statement do not 
have ASCII string constants converted to their length delimited form at the time the 
macro call statement or the MAC statement is processed. This conversion occurs when 
the parameter values are subsequently used as alphanumeric values within the macro 
routine. 


Any combination of characters may be used as an argument of a macro call or a MAC 
statement provided that the rules described below are obeyed. 


The following conventions have been defined for alphanumeric values. 


ALPHANUMERIC VALUE CONVENTIONS 
Balanced Apostrophes 


An alphanumeric value may contain one or more quoted strings. A quoted string is any 
sequence of characters that begins and ends with an apostrophe. Any apostrophe to be included 
as part of the quoted string must be entered as a pair of apostrophes (i.e., two consecutive 
apostrophes). An apostrophe cannot also be paired with a third apostrophe within the quoted 
string. | 

The first quoted string starts with the first apostrophe in the argument. A quoted string ends 
with the first “even-numbered” apostrophe that is not immediately followed by another apos- 


trophe. Subsequent quoted strings start with the first apostrophe after the apostrophe that ends 
the previous quoted string. 


The first and last apostrophes of a quoted string are called “balanced” apostrophes. 


The following example contains two quoted strings. The first and fourth and the fifth and sixth 
apostrophes are balanced sets of apostrophes (i.e., E is not a quoted string). 


-ABC’D’E’F’ | | 
NOTE: Commas, semicolons, parentheses, spaces, and horizontal tabs within a quoted string do 
not terminate an alphanumeric value. 


Balanced Parentheses 


If an alphanumeric value or a macro call argument or a MAC statement argument contains 
parentheses, there must be an equal number of left and right parentheses. The nth right 
parenthesis must appear to the right of the nth left parenthesis. 


A “set” of parentheses is balaced when a right parenthesis follows the left parenthesis. Any 
intervening parentheses must be members of an included set of balanced parentheses. The 
included set must be entirely between the including set. In the following example, the first and 
fourth, the second and third, and the fifth and sixth parentheses are sets of balanced paren- 
theses: 


(ABC(D)E)(F) | 
A parenthesis that appears between balanced apostrophes (i.e., is part of a quoted string) is 


not considered in determining balanced parentheses. In the following example, the middle 
parenthesis is not considered: | 


()’) 
NOTE: Commas, semicolons, spaces, and horizontal tabs between balanced parentheses do not 
terminate an argument of a macro call. | 
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Commas and Semicolons 


A comma or semicolon which is not between balanced apostrophes or balanced parentheses 
indicates the end of an alphanumeric value, the end of an argument ofa macro call, or the end of 
an argument of a MAC statement. The following example shows one argument containing the 
two commas: | 

(ABC,DE)F’°G,H’ 


NOTE: The comma or semicolon that terminates an argument of a macro call is not considered to 
be a part of that argument. 


A comma is used to terminate an argument if the next argument begins on the same source 
line. The next argument starts with the first character following the comma that is neither a 
space nor a horizontal tab. , 


A semicolon is used to terminate an argument if the next argument begins on the next source 
line. In this case, the next argument starts with the first character that is neither a space nor a 
horizontal tab (following the line number, if present) on the next source line. 


Spaces and Horizontal Tabs 


A space or horizontal tab indicates the end of an alphanumeric value, the end of the last 
argument of a macro call, or the end of the last argument on a MAC statement unless the space 
or tab appears: 


e Between balanced apostrophes. 
@ Following a comma. 


e Following the line number of a continuation line with no intervening characters, other 
than additional spaces and horizontal tabs. 
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Appendix A 


( Programmer’s Reference 
. Information 


This appendix summarizes information about the internal representation of the assembly 
language instructions, the operations they perform, and other useful data for coding and 
debugging your program. 


SUMMARY OF HARDWARE REGISTERS 


Figure A-1 is a list of Level 6 registers and their formats. The length of each register is shown 
in bits. 


: Bit: 0 uaa 
Program Counter 
(P-Register) INSTRUCTION ADDRESS 

Bit: 0 19* 


Base Regist 
Se PEUISERY INSTRUCTION ADDRESS 


Bit: 0 15 
General Registers 
(R1 through R7) ANY DATA 
Bit: O 7 
Mode Control Registers MODE 
(M1 through M7) INFORMATION 
Bit: O 19 


Stack Address 
Register (T) ADDRESS OF CURRENT STACK 


*15 for 6/30 models, 19 for 6/40 and 6/50 models 


Figure A-1. Level 6 Hardware Registers 
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Bit: 
System Status 


Register Ze 
(S) a 
Interrupt level of 
current program 
Processor identifi- 
cation (set automatically) 
1 = System in privileged 
state 
Bit: 123 5 6 9 10 15 
Memory Protection aS : 
Unit — System 
Status Register ee 
(S) — 
Interrupt level of 
current program 
Processor identification 
(set automatically) 
Current ring value, possible 
values: 
: System in privileged state 
01 System in user state 
00 
Bit: 6) 78 910 1112 #413 «14 15 aa 
Indicator : 10 | 
Register Vv C Gy;L YU Sw 
(1) me 
ge Result of last 
compare 
1 = |/O command 
accepted 
1 = Bit test 
indicator 
1 = Carry 
1 = Overflow 
Name Format _ 
Bit: 0 678 | 63 
Scientific Accumulator Cc 
Registers 
($S1 through $S3) 
_ Magnitude of the mantissa 
Sign (O=positive, 1=negative) 
of the mantissa; 
Characteristic (excess 64 
power-of-16 exponent) of 
the number 
, 
Figure A-1 (cont). Level 6 Hardware Registers Ne 
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Scientific Indicator 
Register (SI!) 


Result of fast 
scientific compare: 


Less than 
Greater than 


Precision error 
(trap 22) 


Scientificance error 
(trap 21) 


QLT failed (trap 31) 


Exponent underflow 


(trap 19) 
Bit: 0 1 2 3 4 5 6 7 
(M4) 
SA1 SA2 SA3 

iIR/T: Round/Truncate Mode 
0 - Truncate 
1 - Round 

iML: Memory Length (Length of main memory data 
field to or from which data is transferred 
via a scientific accumulator (SA)) 
O - Two words 
1 - Four words 

AL: Accumulator Length (Length of scientific 
accumulator data field to or from which 
data is transferred to/from main memory, 
a hardware register, or another SIP - 
register) 
0 - Two words 
1 - Four words 

Bit: 0 1 2 3 4 5 6 7 
SIP Trap Mask Register 
(M5) 


Precision Error Trap Mask 
Significance Error Trap Mask 


Exponent Underflow Trap Mask 


Bit: 


Commercial processor 
Indicator Register (C1) 


0 1 2 
jov| tal SF f 


OLT Error 

Less Than 

Greater Than 

Sign Fault 
Truncation Indicator 
Overflow Indicator 


Figure A-1 (cont). Level 6 Hardware Registers 
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Bit: 


Commercial Processor 
Mode Register (CM) 


Truncation Trap Mask 
0 - Do not trap 
1 -Trap 


Overflow Trap Mask 
0 - Do not trap 
1 - Trap 


0 19 


| ; Bit: 
Sct arts oe ADDRESS OF REMOTE 
pee DESCRIPTOR ARRAY 


Figure A-1 (cont). Level6 Hardware Registers 


ASSEMBLY LANGUAGE INTERNAL FORMATS BY TYPE 


Each of the seven types (i.e., generic, branch-on-register, etc.) of assembly language 
instructions is stored in memory in a predefined format, as shown in Figure A-2. 
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ee 


Leper = 
i : 
\ ; 


012 3 4 5 6 7 8 9 10 11 12 13 14 15 


000 0 00 90 0 FUNCTION 


ADDITIONAL WORD(S), IF NECESSARY 


Generic (GE): 


0 0 00 OPCODE DISPLACEMENT? 


REGISTER TYPE, DIRECTION, 

NUMBER |9 O O O DISTANCE 

REGISTER a 

NUMBER OPCODE DISPLACEMENT 

REGISTER 

NUMBER OPCODE 

. DATA ADDRESS 

ADDITIONAL WORD(S), IF REQUIRED BY ADDRESS 
SYLLABLE AS DEFINED BELOW 


Branch-on-indicator (BI): 


Shift (SHS and SHL):. 


Branch-on-register (BR): 


Short value immediate (S!): 


Input/output (10): 


| 


10 AND 1OH 
EMBEDDED CONTROL WORD 
ADDRESS SYLLABLE 
00 0 0 00 0 0 0o|ADDRESS SYLLABLE + 
| ADDITIONAL WORD(S)>). 
ADDITIONAL WORD(S), IF REQUIRED? 
OLD ADDRESS SYLLABLE 


00000000 0 ADDRESS SYLLABLE +, | 
ADDITIONAL WORD(S) 


RANGE ADDRESS 
00 0 00 0 0 0 0 SYLLABLE 


ADDITIONAL WORD(S), IF NECESSARY? 


OPCODE ADDRESS SYLLABLE 


( Single operand (SO): 


ADDITIONAL WORD(S), IF NECESSARY? 
REGISTER 
NUMBER | OPCODE ADDRESS SYLLABLE 


ADDITIONAL WORD(S), IF NECESSARY 


Double operand (DO): 


| ADDRESS 
1 0 0 O |] OPCODE ADDRESS SYLLABLE 
EMBEDDED CONTROL WORD 


If the displacement value specified is 0, the location to be 
branched to is specified in the next sequential word(s); if it 
is 1, the next sequential word(s) specifies the displacement 
(in words) from the address of this displacement word; other- 
wise,the displacement value specified is the displacement, 
in two's complement form, from the current instruction to the 
destination. 


Depending on the form of the address experssion used in the 
source code, the generated object text may occupy one, two, 
or three words as follows: 


o If the address expression was of the immediate memory, 
immediate operand, or P-relative address forms, the 
hexadecimal address of the location specified, the dis- 
placement to it, or the value of the oeprand itself is 
contained in the next sequential word or words. 


o If the address expression was of the B-relative address 
form, the address of the location is derived by per- 
forming the operation(s) specified in Table A-3. 


o If the address expression was of the register addressing 
form, the value or address is contained in the specified 
register. . 


For those instruction types that show register number in bits 
1 through 3, this is the number of register specified in the 
first operand of the multiple-operand instruction that re- 
quires a register in the first operand. 


Figure A-2. Internal Formats of Assembly Language Instructions 
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HEXADECIMAL REPRESENTATION OF INSTRUCTIONS 


Table A-1 illustrates the hexadecimal representation of the CPU and SIP assembly language 
instructions as they appear in a printout. These representations are derived from the formats of 
the various types described under “Assembly Language Internal Formats _ Type” 
(Figure A-2). 


In the table, when 0+ addsy]l or 0+x is specified, it indicates that the last byte is a 7-bit byte 
preceded by a binary 0; 8+ addsy] or 8+ x indicates a 7-bit byte preceded by a binary 1. In either 
case, only the last seven bits are significant. Addsy] is defined in Table A-2; x is the displacement 
in a branch instruction, as defined under “Assembly Language Internal Formats by Type” 
(Figure A-2); dis the shift displacement, in bits. See Appendix H for hexadecimal representation 
of Commercial Processor instructions. 


TABLE A-1. INTERNAL REPRESENTATION OF ASSEMBLY LANGUAGE INSTRUCTIONS 


Fourth 


First Second Third 
Hexadecimal Hexadecimal Hexadecimal | Hexadecimal 
Digit Digit Instruction | Type 


Digit Digit 


0 
l 
pi 
3 
4 
5 
6 
7 
0 8 
0 A GE 
0 B 
M 0 C 
0 D 
1 1 
6 0 
6 ‘| 
6 2 
6 3 
2 O+x x 
pi 8tx x BGE 
3 Otx x BG 
3 8tx x BLE - | BI 
4 O+x X BOV 
4 8tx x BNOV 
5 O+x x BBT 
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TABLE A-1 (CONT). INTERNAL REPRESENTATION OF ASSEMBLY LANGUAGE INSTRUCTIONS 


First Second 
Hexadecimal Hexadecimal 
Digit Digit Instruction | Type 
5 
6 
6 
7 
7 
8 
8 
0 9 
9 
A 
A 
B 
B 
F 
F 
4 SBLZ 
SBGEZ BI 
1-3 5 SBEZ 
SBNEZ 
6 SBGZ 
SBLEZ 
4 
5 
6 
qd 
1 
2 
3 
4 
5 
6 
1-7 7 
8 
9 SHS 
A 
B SHL 
C 
D 
E 
F 
PROGRAMMER’S REFERENCE 
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TABLE A-1 (CONT). INTERNAL REPRESENTATION OF ASSEMBLY LANGUAGE INSTRUCTIONS 


Second Third 
Hexadecimal 


Digit 


First 
Hexadecimal 


Digit Digit 


1-7 


co 
NNKF OCOCOlODU MOLD TAMMBVAAWWS SOKO MHANINDAAWNN!]- KH OlamMUOlw~ws >vUwoOM HIN 
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a ot a oo 


be 


Otaddsyl 
O+addsyl 
8t+addsyl 
O+addsyl 
8t+addsyl 
8taddsyl 
O+addsyl 
8t+addsyl 
O+addsyl 
Otaddsyl 
8t+addsyl 
O+addsyl 
8taddsyl 
Ot+addsyl 
8taddsyl 
Ot+addsyl 


‘Staddsyl 


O+addsyl 
8taddsyl 
O+addsyl 
8taddsyl 
Ot+addsyl 
8taddsyl 
O+addsyl 
8taddsyl 
O+addsyl 
9+addsyl 
O+addsyl 
8taddsyl 
O+addsyl 
8t+addsyl 
Ot+addsyl 
8taddsyl 
8taddsyl 
Otaddsyl 
8taddsyl 


A-8 


Fourth 
Hexadecimal 
Digit 


immedvalue 
immedvalue 
immedvalue 
immedvalue 


_ Instruction 


BDEC 


BINC | 


BLZ 
BGEZ 
BEZ 
BNEZ 
BGZ 


BLEZ | 


BEVN 
BODD 


Type 


BR 


SI 


IO 


SO 
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TABLE A-1 (CONT). INTERNAL REPRESENTATION OF ASSEMBLY LANGUAGE INSTRUCTIONS 


First Second 
Hexadecimal Hexadecimal Hexadecimal | Hexadecimal 
Digit Digit Instruction | Type 
3 O+addsyl 
3 8t+addsyl 
4 Ot+addsyl 
4 | 8t+addsyl 
9-F 5 O+addsyl 
5 8taddsyl 
6 O+addsyl 
6 8t+addsyl 
7 O+addsyl 
7 8t+addsyl 
8 O+addsyl . 
B i 
De red tadesy SCM 
9-F po taddsyt | CMR 
= rs «d SS aaesyt ———S*d said 
De 
A O+addsyl ADD 
A 8+addsyl SRM 
9-F B Ot+addsyl MUL 
B 8taddsyl LAB 
o 
De Oraddsyl 
C 8t+addsyl LDB 
D 8t+addsyl CMB 
9-F E Ot+addsyl SWR 
E 8taddsyl SWB 
F O+addsyl STR 
F - 8taddsyl STB 


TABLE A-2. ADDRESS SYLLABLES FOR CPU & SIP INSTRUCTIONS 


000 < location *$Bn 
001 <location.$RI *$Bn.$Rl 
010 <location.$R2 *$Bn.$R2 
O11] <location.$R3 *$Bn.$R3 
100 location — *Bn.value 


101 reserved © $Bk.-$R1 $Bq.+$R1 


110 reserved $Bk.-$R2 $Bq.t$R2 


111 4 SIV. value $Bk.-$R3 $Bq.t$R3 
=Vvalue 


NOTE: An address syllable can be represented as mmmirrr, which are the last seven bits in the word; n can be any number 
between 1 and 7 and is equal to rrr for rrr#0; k is a number within the range 1 through 3 and is equal to rrr for 
rr = 1, 2, 3; and q is a number within the range 1 through 3 and is equal to rrr-4 for rrr = 5,6, 7. For more in- 
formation about these address expressions, see “Addressing Techniques” in Section 5. 
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VALID ADDRESS EXPRESSIONS 


_- Table A-3 lists all of the valid address expressions and shows graphically how each derives the 
effective address of the data to be used in the operation. 


The various types of symbolic names, constants, and expressions (other than address 
expressions) are described in detail in Section 2. 


TABLE A-3. SUMMARY OF VALID FORMS OF ADDRESS EXPRESSIONS FOR CPU 
| AND SIP INSTRUCTIONS 


Address | 
Addressing Expression Generation of 
Technique Form Effective Address 
Register Rn = EA 
Addressing Bn = EA, 


Sn = EA, 


Immediate Direct locexpression 
Memory 4 . | 
Addressing -) templabel location = EA 


Indirect 


os 


{ 
! 
| 


location = EA 


Indexed 
Direct < 


locexpression 


‘"t location+ R <2 
-) templabel 3 
locexpression 


| l 
+ location+ R f EA 
- templabel 3 


Immediate Address of current address 


Addressing 
a nr mae 

extvallabel 
P-Register intlocexpression 
Addressing | Direct ‘‘t 

-) templabel internal location EA 
| | Indirect 

internal location, 


B-Register $Bn Bn = EA 


Addressing Indirect *F Bn Bn, = location 
location, = EA 
Indexed 1 l 
Direct $Bn.$R <2 Bn, + R <27= EA 
(3) 


(3) 


EA 


Indexed 
Indirect me < 


locexpression 
CI 
-§ templabel 


intlocexpression 
* ." 


-) templabel 


EA 


Bn = location 


l 
location + R * = EA 
3 


Bn_+ value = EA 


Indexed 
Indirect 


Direct + $B eae aaa 
Displacement ”Vextvallabel 
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TABLE A-3 (CONT). SUMMARY OF VALID FORMS OF ADDRESS EXPRESSIONS FOR CPU 


Address 
Addressing Expression 
Technique Form 


B-Register Indirect + intvalexpression 
Addressing | Displacement *$Bn. lextvallabel 
(Cont.) 


B6 direct + $B6.sLCOMW + 
Displacement intvalexpression 


Indexed Push 
Indexed Pop 
Short | intlocexpression 
Displacement = ‘*t 
-) templabel 
7 ree rma 
Special ~ Yextvallabel 
intvalexpression 
Interrupt Vector siv,| See aebal 


NOTE: The symbols used in this table have the following meanings: 


—~- Contentsof... - 
EA -_ Effective Address < 
<« - Replaces the element pointed at > - 
locexpression — location expression (any type) = 


templabel - temporary label .- 
stringconstant - string constant 

intvalexpression — internal value expression 

extvallabel - external value label 

intlocexpression — internal location expression 


Generation of. 
Effective Address 


Bn + value = location 
location = EA 
teenteenrrneermssarests 


B6 + value = EA 


B6 + value = location 
location = EA 


location = EA 


Word following the word(s) 
containing op code + first 
operand address syllable = EA 


IV + value = EA 
a | 


Indirect memory addressing 
Immediate memory addressing 
Short displacement addressing 
Specified Addressing 
Component separator 


(indexing and displacement) 


All other notations represent standard usage as defined in the preface of this manual or 


required Assembler-specific symbols. 
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Appendix B 


- Hexadecimal 
( | Numbering System 


Level 6 stores all data in memory in the form of binary digits. However, to save space in 
printouts, this data is always shown in its hexadecimal equivalent (unless an ASCII memory 
dump is requested). This appendix explains how to convert from hexadecimal to decimal and 
vice versa, as well as how to perform hexadecimal arithmetic operations. 


Table B-1 shows the comparison between binary (i.e., base 2), decimal (i.e., base 10), and 
hexadecimal (i.e., base 16) symbols. 


TABLE B-1. COMPARISON OF BINARY, DECIMAL, 
AND HEXADECIMAL SYMBOLS 


Binary Decimal Hexadecimal 


0000 
0001 
0010 
OO11 | 
0100 
0101 
0110 
O11] 
1000 
1001 
1010 
1011 
1100 
1101 
1110 
1111 


CONDON BWN kK © 


( 


Ne 
MMOUOAWP>FOMIDNAWNHO 


a ee 
MB WN K © 


In the course of coding your assembly language program, it is possible to define data as a 
decimal, hexadecimal, or binary number, or as an ASCII symbol, as illustrated in Table B-4. 
However, in memory, all data is stored in binary. 


Data that is defined as ASCII in the source program is stored as the binary equivalent of the 
ASCII symbol, and shown in the printout as the hexadecimal equivalent of the stored binary 
value. 


Numeric data is stored as binary, and is shown in the printout as the hexadecimal equivalent 
of the stored binary value. 


Table B-2 illustrates how the value 32 is stored in memory depending on how it is defined in 
the source program (i.e., depending on whether it is defined as an ASCII value, binary value, 
decimal value, or hexadecimal value.) In addition, it shows how the stored value would appear in 
an ASCII or hexadecimal printout. 

As you can see in this table, hexadecimal and binary are identical. In addition, it illustrates 
how an ASCII symbol is expanded according to Table B-4. Finally, it shows a decimal value that 
is first converted to its hexadecimal (i.e., binary) equivalent and then stored in memory. 


The following pages explain how to compute the conversions and how to do hexadecimal 
arithmetic. 
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TABLE B-2. STORAGE AND PRINTOUT OF VALUE 32 


Data Type Stored in Memory Hex Printout ASCII Printout 
AC32 0011001100110010 3332 32 

X32’ 00000000001 10010 0032 2. 

L372 0011001000000000 — 3200 2. 

32 (Dec) 0000000000100 000 0020 Space 
B’00110010° 0011001000000000 3200 2. 


DECIMAL-TO-HEXADECIMAL CONVERSION 


The system automatically converts all decimal data to its binary (i.e., hexadecimal) equiva- 
lent when storing it in memory. It then operates on that binary data. 


You can determine how a decimal number will be stored in memory as follows: 


1, 


Divide the decimal number by 16. The remainder becomes the low-order (i.e., rightmost) 
hexadecimal digit. 


Divide the whole number result of the last division by 16. The remainder becomes the 
next-highest-order hexadecimal digit. - 


Continue this process until the whole number result of a division is 0. The remainder 
becomes the highest-order (i.e., leftmost) hexadecimal digit. 


For example, to determine the hexadecimal equivalent of the decimal number 27,401, do the 


following: 
1. Divide 27,401 by 16. 
The result is 1712. The remainder is 9. 
2. Divide 1712 by 16. 
The result is 107. The remainder is 0. 
3. Divide 107 by 16. 
The result is 6. The remainder is 11. 
4. Divide 6 by 16. 


The result is 0. The remainder is 6. 


Using Table B-1, you can see that in hexadecimal 11 is represented by B. Thus, the hexadeci- 
mal equivalent of 27740110 is 6BO9. 


HEXADECIMAL-TO-DECIMAL CONVERSION 


The type of conversion you will most commonly be confronted with will be from hexadecimal 
to decimal because, unless you specifically request an ASCII memory dump, printouts of 
memory will always be in hexadecimal. To identify ASCII data coe look for repetition of the 
first character in a byte. For example, 


3132 3333 3335 3637 xxxx xx.. 


is a list of ASCII numbers (i.e., 1, 2, 3, 3, 3, 5, 6, 7, in the seearcie In most other cases, the 
hexadecimal symbols will appear to be quite random. If the stored hexadecimal symbols 
represent numeric data, you can convert it to decimal as follows: 


. 


oe ae 


Multiply the decimal equivalent (see Table B-1) of the high-order (i.e., leftmost) 
hexadecimal digit by 16. — 


Add the decimal equivalent of the next-lowest-order hexadecimal to the result of step 1. 
Multiply the result of step 2 by 16. 
Repeat steps 2 and 3 until you reach the last hexadecimal digit. 


Simply add the decimal equivalent of the last hexadecimal digit to the result of the last 
previous multiplication. 
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a 


ree oa 


For example, to convert the hexadecimal value 1C8A to its decimal equivalent, do the 
following: 


1. Multiply 1 by 16. 
The result is 16. 


2. Add 12 (i.e., C = IZ io): 
The result is 28. 


3. Multiply 28 by 16. 
The result is 448. 


4. Add 8. 
The result is 456. 


5. Multiply 456 by 16. 
The result is 7296. 


6. Add 10 (i.e., A = 10,0). 
The result is 7306. 


Thus, the decimal equivalent of 1C8A,, is 7306. 


Alternatively, you may use Table B-3 to convert hexadecimal numeric data to its decimal 
equivalent. 


TABLE B-3. HEXADECIMAL/DECIMAL CONVERSION 


Word 
Byte Byte 

Hi = Decimal H4 Decimal 
0 0 0 0 0 0 0 0 
| 4096 l 256 ] 16 ] ] 
2 8192 pi S12 Z 32 2 2 
3 12288 3 768 3 48 3 3 
4 16384 4 1024 4 64 4 4 
5 20480 5 1280 5 80 5 5 
6 24576 6 1536 6 96 6 6 
7 28672 7. 1792 7 112 7 7 
8 32768 8 2048 8 128 8 8 
9 36864 9 2304 9 144 9 9 
A 40960 A 2560 A 160 A 10 
B 45056. B 2816 B 176 B 1] 
C 49152 C 3072 C 192 C 12 
‘D 53248 D = 3328 D 208 D 13 
E 57344 E 3584 E 224 E 14 
F 61440 F 3840 F 240 F 15 


NOTE: H1 is the first hexadecimal digit. 
H2 is the second hexadecimal digit. 
H3 is the third hexadecimal digit. 
H4 is the fourth hexadecimal digit. 


If H1 is 0 through 7, the number is positive and you compute the decimal equivalent of the 
given hexadecimal number by summing the decimal equivalent of H1, H2, H3, and H4. 


( Note: 
ee For a signed integer byte, use H3 and H4 only. 
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If H1 is 8 through F, the number is negative, and you must find the twos complement before 
using the table. You can compute the twos complement by subtracting the hexadecimal number 
from 10000 (hexadecimal) or by changing all 0‘s to 1 and then adding a binary 1. The twos 
complement can also be computed by performing the ones complement of all of the bits that are 
to the left of the rightmost 1. (e.g., the twos complement of 0011 1000 1100 0000 is computed by 
“flipping” the leftmost 9 bits giving 11000111 0100 0000.) This assumes that the twos comple- 
ment of zero is zero. You can then find the decimal equivalent directly from the table, appending 
a minus sign to the final result. 


HEXADECIMAL-TO-ASCIi CONVERSION 


If the stored data is an ASCII value, it can be translated by converting the hexadecimal value 
in the printout to its ASCII equivalent using Table B-4. 


For example, the locations that contain the start of your program should have the following 
hexadecimal representation: | 


5449 544C 4520 hhhh hh... 


By pairing the digits (e.g., 54) and locating the character in the table where these two digits 
intersect, you can ascertain the ASCII equivalent of the stored hexadecimal value. 
Remembering that the first hexadecimal digit corresponds to the H1 row and that the second 
digit corresponds to the H2 column, the above representation translates to: TITLEA. 


If you wish to ascertain the hexadecimal equivalent of an ASCII character, simply locate the 
character in the table and record the H1H2 values at the top and left of the table. 


TABLE B-4. HEXADECIMAL/ASCII CONVERSION 


NUL SI wee 

SOH _ Start of He: ie vertical Tab 

STX Start of Tex FF Form Feed 

ETX ~~ End of Text CR Carriage Return 

EOT End of Transmission | SO Shift Out 

ENQ- Enquiry ; SI Shift In 

ACK Acknowledge > DLE Data Link Escape 

BEL Bell | DC1 Device Control 1 

BS Backspace DC2 Device Control 2 

HT Horizontal Tab DC3 Device Control 3 
HEXADECIMAL 
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DC4 Device Control 4 _ ESC Escape 


NAK Negative Acknowledge FS File Separator 
SYN Synchronous Idle GS Group Separator 
co ETB _ End of Transmission Block RS Record Separator 
( CAN Cancel US Unit Separator 
EM End of Medium SP Space 
SUB Substitute DEL Delete 


HEXADECIMAL ADDITION 


Table B-5 illustrates a hexadecimal addition table. When using this table, whenever there is a 
result that hasa 1 preceding a hexadecimal value, that 1 represents a carry. 


TABLE B-5. HEXADECIMAL ADDITION TABLE 


( 


The following example illustrates how the table can be used in hexadecimal addition: 


augend A2B5 
addend | +494F 
sum EC04 


The result of adding F and 5 is 14. Therefore, 4 becomes the low-order digit in the sum; 1 is 
carried. Then, B + 4 + 1 = 10; as before, 0 becomes the next-lowest-order digit, and 1 is carried. 
Then, 9 + 2 + 1 = C; there is no carry. Finally, A + 4 = E, with no carry. The sum of the 
hexadecimal numbers shown above is EC04. 


HEXADECIMAL SUBTRACTION 


Hexadecimal subtraction is the opposite of hexadecimal addition. Instead of carries, it is 
necessary to borrow. When you borrow a 1 from the next-highest-order digit of a minuend, it is 
the equivalent of adding 16 to the minuend of the digit you are subtracting from. The following 
example illustrates this concept: 


minuend 3A 
subtrahend 1B 


difference 1F 


eo Since B is higher than A, it is necessary to borrow 1 from the 3, and adding 16 to A (i.e., 16 + 10 
( a! = 26), and subtracting B (i.e., 11) from the result, obtaining 15 (but since this is hexadecimal 
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arithmetic, you must change the 15 to F); then, you must subtract 1 from 2 (don’t forget that 1 


was borrowed from the 3); the result of this operation is 1F. 


HEXADECIMAL MULTIPLICATION 


To do hexadecimal multiplication, you can use Table B-6. As when multiplying in any 
numbering system, you must record the low-order digit and add the remainder (i.e., the 


_ high-order hexadecimal digit shown in the table) to the result of the multiplication of the 


next-lowest-order hexadecimal digit. 


TABLE B-6. HEXADECIMAL MULTIPLICATION TABLE 


fa t2 [3 [4 [s [6 [7/3 [9 {a {Bic {ple [F 


pmoend od jee . 
ow \O ook ee Bon MiB lw low ipl 
OQ \O | CO} CO] YJ OM? | HR] . [do 


For example, to multiply the following hexadecimal digits: 


multiplicand 2A5 
multiplier x3 
product | TEF 


Using the table, 3 x 5 = F, and there is no remainder. Then, 3 x A = 1H, Eis recorded, and the 
remainder (i.e., 1) is saved to be added to the result of the multiplication of the next digit. So, 3 x 
2 = 6, plus the remainder of 1 = 7. The result of this arithmetic operation is 7EF. 


HEXADECIMAL DIVISION 


Due to the complexity of this type of operation, it is suggested that you convert the 
hexadecimal digits to decimal, perform the division, and then convert the answer to 
hexadecimal. 
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Appendix C 


Sample Assembly 
Language Program 


The following sample programs illustrate many of the aspects of the assembly language 
described in this manual. For a definition of the fields that appear in the listings, refer to the 
Program Execution and Checkout manual. 


CHKNML —SAF 1977/11/21 0940:05.6 ASSEMBLER—0 100—11/09/1223 GCOS6 MOD0400-S100—11/17/0634 PAGE 0001 


000001 TITLE CHKNML 

000002 * PPOGRAM COMPARES TEST RESULTS OF TEST MUDULES WHOSE ADDRESSES ARE 
000003 * STUREU IN SCUMM TO THE EXPECTED TEST RESULTS AS DESCRIBED IN TABLOC 
000004 X VAL. TSTMAX 

000005 xLOC TAKBLOC 

000006 — XLOC ZIUSOL 

000007 , XLOC ZLOSWR 

000008 XLOC Z10aSco 

000009 0100 come x' {aa 

000010 * GET FILENAME AND CHANNEL NO 

000011 0000 AB43 FFEF STRT Lipk SR2,SH3.°17 

000012 0002 BBAS LAB SH5,3R5.$R2 

000013 6003 BBCS FFEC LAt U3, 203.°720 SET t3 TO LIST FILE AT 
000014 0005) 9873 LOR $R1,+8B3 SET 83 TU FILENAME 

000015 0006 1002 ChMy DRi1ee 

000016 0007 O9B1 OU7TC ANE ERNLST NO LIST FILE ATTACHED 
000017 0009 9843 0UU7 LO SRL SHS. 7 SET R1 TO CHANNEL NO, 
000018 * OPEN LIST FILE 

000019 0008 CRCO 0079 LAB SB4,LSTOCH 

000020 000D 0380 0000 x LNJ SB5,<2I10SO0L OPEN ROUTINE 

000021 U000F 1981 OQ06F BNE Z SRL,EROPE I 

00002e * wRITeE READER MSG 

000023 dO011 POLE LIV $R1,K'tE! MSG LENGTH 

000024 QO01e eC00 LDV SRe,x'0! 

000025 0013 b&BCO 0081 LAB bH3,WwHUFO! MSG ADDRESS 

000026 0015 CBCO O06F LAK $B4,LSTOCB 

G00027 0017 D380 0006 x LN $85,<Z10SWR WRITE ROUTINE 

000028 0019 1981 0066 BNEZ oki, FRHDR 

000029 0018 SCFF Lov bR3,"X' 1! 

000030 QO01C 3£01 TLOOP ADV DRS, XIL! 

000031 0010 8B97¢G 0000 X CMR $R3,=TSTMAX CHECKED ALL TEST RESULTS ? 
000032 O01F 0301 OO4E BG ENUTST 

000033 00e1 CCs0 0000 K LOIS $d4,<ECOMM, $k3 

000034 0023 CBC4 OOITC LAK €B4,5B4.x'1C! CREATE STATUS BLOCK PTR 
000035 0025 F830 0000 xX LAR SRY, <TABLCC. SRS GET EXPECTED VALUE 

000036 O027 F944 00035 CMR $R7,35B4.x'3! COMPARE TO ACTUAL STATWD 
000037 0029 0973 BE >TLOOP TEST OK = CHECK NEXT TEST 
000038 002A EBCO 007A LAB BBoO,WLIF 2A 

000039 onec DB30 0090 K LOR $RS,<4fCOMM SPS 

000040 O02E FSCO 0027 LMJ 3B7,DUMPHD CONVERT TEST ADDR TO ASCII 
000041 0030 E8CO 0077 LAb 3BO,iWBUF OR 

000042 0032 010804 LOk PRS, SBa4 

000043 0033 %>F3C0 C022 LNJ 2B87,DUMPWD CONVERT SYML VALUE TU ASCII 
000044 0035 CBC4 000} LAB $B4,5B4.X'1' 

000045 0037 ECU 0073 La& Stio, WHUF 2C 

000046 0039 D804 LDR $R5,964 

000047 OC3A F3CO 001K LN SE7,D0UMPHD CONVERT TEST NUM TO ASCII 
000048 003C CRE4 0001 LAB $B4,$B4,X'1' 

000049 O03E EBCO O06F Lab SHO, WRUF 2D 

000050 0040 0804 LOR R5,%64 

000051 0041 >F3CO 0014 LiNJ $8B7,0UMPWD CONVERT SYMV VALUE TO ASCII 
000052 0043 CBC4 0001 LAb $B4,$64.X' 1! 

000053 0045 EBCO 006B LAB bo, NW BUF CE 

000054 0047 D&04 LDR SRS, 3B4 

000055 0048 FSCO 0000 LNJ B77, DUMPIWD CONVERT STATUS WORD TO ASCII 
000056 * WRITE VALUES 

000057 QO4A ICiIE LOV SRIi,X'LE! MSG LENGTH 

000058 004B eCo0d LOV rpRe,x'Q! 

000059 Q004C BBCO 0U57 LAB $B3,WBUF 20 MSG ADDRESS 

000060 O04E CBCO 0036 LAB $B4,LSTOCB 


Figure C-1. Listing of CHKNML Program 
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CHKNML —SAF 1977/11/21 0940 : 05.6 ASSEMBLER—0100—1 1/09/1223 GCOS6 MD0400—S100—1 1/17/0634 PAGE 0002 


000061 0650 D338 OuOdU X LJ $BS,<Z1USWR WRITE ROUTINE 
000062 0052 1981 OGe2E BNEZ SR1,ERVAL | 
000063 0054 &3C0 FFC7 Jue TLOUP 
000064 * ROUTINE ACCEPTS A VALUE IN RS AND PUTS ITS ASCII EQUIVALENT 
000065 * IN THF TwO WURDS POINTED TO KY bb 
000066 0056 <4CFC DUMP iD LDv SRO,-xX'a! SET COUNTER 
000067 0057 CFav vdud T STR SRU,+HC 
000068 0059 7C00 LOV R7,X'Q! 
000069 QOdSA 4C00 bA LOV gku,x'o! 
000076 00S5R 5084 DOL $RS,4 
000071 005C 4ES50 ADV SRu,X'3y! 
000072 005D C940 0000 1 CMR $RU,+3F 
000073 O0OSF 00380 T BLE 2+ BE 
000074 Q060 AEDT ANY yee ae Oley ied 
000075 0061 Fuse dE Ok $R7,=ERU 
000076 0062 8ALO .FFFS T INC +$L 
000077 0064 0600 T BCT >+$I) 
000078 O65 7088 NOL dR7,8 
000079 0066 UFFU T B >= SA 
000080 0067 EFde 0000 $D STR SRO, SBO.X'0! 
000081 0069 FFube odd} STR OK7,SBbo.xX'1! 
000082 00686 8387 JMpeP SK7 RETURN TO CALLER 
000083 d0ec 0000 $C DC Zz 
000064 d006D 0039 $F DC Z2'0039! 
000085 * WRITE END TEST 
000086 vU06E ,iCuaA ENDTST LDY S$R1,X'At MSG LENGTH 
000067 VU06F eC00 Liv pkKe, X'Q! 
000088 0070 BECO 0043 Lats 5B3,wBUFOS MSG ADDRESS 
000089 vu072 CBCO 00i1e LAB $B4,LSTOCE 
000090 0074, C380 0000 x LNJ $BS,<ZI0SWR WRITE ROUTINE 
00009} 0076 1981 U00K RYE Z SRIL,EREND 
000092 . *- CLOSE LIS) FILE : 
000093 O0u78 CBCO OGOC LAB - $B4,LSTDCB 
000094 Q07A D360 0000 X LNG 4145, <Z1T0SCO CLUSE ROUTINE 
000095 O07C 1981 0006 BNEZ SR1,ERCLS 
000096 O07E 0000 HLT 
000097 O0O7F 0000 EROPEN HLT 
000098 0080 0000 ERHDR HLT 
000099 0081 0000 ERVAL HL 1 
000100 008 0000 EREND HLT 
000101 0083 Q000 ERCLS HLT 
000102 0084 0000 ERNLST HLT 
000103 0085 9000 LSTOCts REGY lo,0 
000104 0095 4ileu WBUFCI OC "A tloc tsyr tval tswa' 
0096 746C 
0097 o6Fo3 * 
0098 2020 
0099 7473 
0094 796D 
009B 2020 
009C 746E 
009D 7560 
009E 2020 
009F 7476 
0040 616C 
00A1 2020 
OVA2 7473 
Q00AS 7764 
000105 O0A4 4120 -WRUFeO DC "A! 
000106 Q045 e2ue20d WBUF2A DC ; ; 
CHKNML PAGE 0003 
0046 2020 
00A7 2020 
000107 G0AB 2020 WtsUF ets DC , : 
00A9 ‘2020 
00AA 2020 
000108 O0AB 2020 WBUF eC OC : ’ 
OO0OAC 2020 
COAL eb2u 
000109 OQAE e029 wRUF ei) DC ‘ 
QOAF 2020 
0080 2020 
000110 0081 2020 WHUF 2E OC ; : 
00B2 2020 
0063 2020 
000111 ORY dieu wBRUFOS DC "A end test! 
GOKRS 656E 
00B6 6420 
0067 7465 
0068 7374 
000112 0069 ENE CHK AML 


0000 ERR COUNT 


Figure C-1 (cont). Listing of CHKNML Program 
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RURBLE 101577 RURBLE SORT “SLTC 1977/12/07 10P1220.8 ASSEMBLER=0100"11/1771346 GFOS6 MND400-8100"12/01/1413 PAGE 0001 


00n00n1 TITLE BURBLF,'191577' BUBRLE SORT 
000002 *THIS SURROUTINE DNES A SIMPLE BUBALF SORT UF WHATFVFR 
n00003 *STNGLF PRECISTON RINARY INTFGFRS ARE TN COMMON RLOCK, DATA. 
000004 *THE SORT LEAVFS THE DATA TN THE CAMMON RLOCK TN ASCFNDING 
N00005 *NUMFRICAL SFQUENCF. 
000006 ® 
N000N7 x*USAGE IS LNT €85,RU0RKI F 
900008 * 
900009 *THIS PRAGRAM WILL EXECUTE IN ROTH SAF AND LAF ANDRESS MONFS, 
000010 *HENCE ASSFMBLFD IN SLIC MODF, 
900011 * 
000012 LODATA EAU DATA 
000013 HINATA EQU DATA+9 
900014 9090 9ACO RURBLE LAB $81,HTDATA 
9090015 0002 ABCO LINE? LAB FRE,LODATA 
000016 0004 1C00 LOV $P1,0 
N00017 9005 R872 LINES $R3,+FB2 
000018 0006 RgN2 $P3,8Re2 
000019 007 0385 s >LINE10O 
000020 9008 1co1 $R1,1 
000021 0009 REND2 R $P3,9R2 
000022 000A RF42 $R3,fReE.7! 
000023 oO0NC ADM1 LINE1G6 $R2,=8B1 
000024 00D 0278 1. >L INES 
900025 O0NE A9FI ' -FB! 
000026 O00F 19F3 $R1,>LINE? 
000027 0010 8385 $R5 
000028 
000029 000A 19 
009030 0000 DATA 
000031 9000 1234 X'1234",99R(15,0),Z'ASDET,INOF+'A', ANDO Z°OFF',X'UGd'),—&53 
0001 063 
0002 A3NE 
0003 4184 
0004 0440 
0005 FCAB 
900032 0006 0000 OeMAX(C*#55,xX'22'),4003,—-X'R000' 
0007 0022 
0008 OFA3 
0009 ROD 
000033 00A BUBBLE 
0000 ERR COUNT 
00152 WORD SYMROL TARLE 


RUBBLE 101577 RURBLE SOART ~SLIC 1977/12/07 1021229.8 ASSEMBLER=$0100"11/17/1346 GCOS6 MAD400-8100—912/01/1413 PAGE 0002 


$B1 kk kk 
SH? kkk el 2? 23 
SBS 
$R1 
$R3 Pld 
RUBBLE 
DATA 
HIDATA 
LINE10 
LINE? 
LINES 
LODATA 
7 LAREIS 
25 REFERENCFS 
33 RECORDS 
0 U FLAGS 
Oo M FLAGS 
1 N FLAGS 


Figure C-2. Listing of Bubble Sort Program 
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Appendix D 


Debugging Assembly 
Language Programs 


There are two ways to debug and correct programs written in assembly language. One is by 
using the Debug program (see the Program Execution and Checkout manual); the other is by 
reading and interpreting the contents of memory through a memory dump (which can be 
obtained by using the Dump Edit utility also described in the Program Execution and Checkout 
manual). 


DEBUG 


This program is intended for use during development phases as a tool for program testing and 
error detection. Debug operates in interactive mode, maintaining a dialog with the operator’s 
terminal. Debug makes visible all memory locations and addressable registers. Using Debug it 
is possible to modify the contents of either the memory locations or the addressable registers. 
Debug also makes it possible to perform memory searches and to display memory areas in both 
_ hexadecimal and ASCII notations. 


See the Program Execution and Checkout manual for a detailed description of Debug. 


DUMP EDIT 


Dump Edit produces on the user file a logical and a physical dump of the contents ofa dump file 
Dump Edit generates, in an edited format, information such as the location and contents of 
hardware dedicated memory locations, the system control block, the group control blocks, and 
the work space blocks for each group control block. 


See the Program Execution and Checkout manual for a detailed description of the Dump Edit. 


AMAL Ue 


READING AND INTERPRETING MEMORY DUMPS 


The remainder of this appendix describes how to read and interpret the contents of memory as 
they appear in a memory dump (see Figure D-1). 


It is possible to interpret the hexadecimal portion of the dump illustrated in Figure D-1, as 
follows: 


1. Since the ASCII portion of the dump shows no readable data, it is apparent that the 
assembly language program contains no string constants in the locations illustrated. The 
hexadecimal digits could probably represent assembly language instructions. 


2. Break each word down into its binary equivalent. For example, C840 in location 003C 
becomes 1100 1000 0100 0000. 


3. Using Table A-1, we find that C indicates that the instruction is probably a double 
operand (DO) instruction. 


4. Continuing to use Table A-1, we find that the 8 plus a binary 0 in the eighth bit position 
indicates that the instruction is LDR. 


5. By checking the table under “Assembly Language Internal Formats by Type” in 
Appendix A, it is possible to interpret the contents of the binary representation 
illustrated in step 2, above. That is, bits 1-3 identify the first operand register; in this case 
$R4 (the LDR instruction requires that the first operand register be an R-register). 


6. Then, using Table A-2, it is possible to interpret the contents of the address syllable 
portion of the binary data shown in step 2; i.e., 1000000. Using the table, the binary data 
corresponds to the columns as follows: mmmirrr. Thus, mmm = 100, i = 0, and rrr = 000. 
In that block, the second operand is in the form of a location label. 
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7. Now you know that the instruction is: LDR $R4,label. Thus, the address expression is the 
P + Displacement form of addressing. 


8. Checking the description of that form of addressing'in Section 5 (see “Addressing 
Techniques”), you see that the displacement between the address of this instruction plus 
1 and the address of the label is loaded into the next consecutive word (i.e., location 003D). 
In this dump, the displacement is 1B4A. 


9. The effective address of the data to be loaded into $R4 is in location 1B86 (i.e., (8C + 1 + 
1B4A)). 


003B/ 23FB C840 1B4A ABCO 1B49 B802 B970 5154 #..@.U...1....-QT 
0043/ 0983. ..83C8 0095 2C02 88D4 88D4 B2A2 3D20) .cccccecvccevee 
ee eee O_o 


ee ie! 
7 HEXADECIMAL PORTION 


ASCII PORTION (DOTS 
(.) INDICATE THAT 

THE ASCII EQUIVALENT 
OF THE HEXADECIMAL 
DIGIT IS A NONPRINT- 
ABLE CHARACTER) 


ADDRESS (IN HEXADECIMAL) 
OF THE FIRST HEXADECIMAL 
WORD (4-DIGIT BLOCK) IN 
THE HEXADECIMAL PORTION 
OF THE DUMP 


Figure D-1. ASCII/Hexadecimal Memory Dump 


Following is a complete list, by address, of the instructions shown in Figure D-1. You can. 


perfect your ability to read memory dumps by interpreting the dump and comparing your 
results to those listed below. The procedure, until you become proficient, is basically as 
described above. After you have had the opportunity to read and interpret dumps several times, 
many of the steps can be skipped, as you will be able to interpret the data without checking all of 
the tables and descriptions identified above. As you can see by the nine steps described above, it 
is imperative that you understand the addressing techniques described in Section 5 (including 
how they are stored in memory), and that you understand how to interpret the address syllable. 


Location Instruction/Meaning 

003B Has no meaning in the context in which it appears; it is probably an 
address associated with the instruction in location 003A. 

003C LDR $R4,label 

003D Displacement between this location and the location containing the label 


identified in the LDR instruction. 


003E LAB $B2,label 
003F Displacement between this location and the location containing the label 
identified in the LAB instruction. 
0040 LDR $R3,$B2 
0041 CMR $R3,=‘QT’ 
0042 Value to be compared to the contents of $R3 in the CMR instruction. 
0043 BNE >$+3 
0044 IMP * label 
0045 Displacement between this location containing the effective address (see 
| “Indirect P-Relative Addressing” in Section 5). 
0046 LDV $R2, 2 
0047 DEC =$R4 
0048 DEC =$R4 
0049 LLH $R3,* B2.$R2 
004A CMV $R3,X‘20’ 
DEBUGGING ASSEMBLY 
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Appendix E 


Notification Flags Issued 
By Assembler 


SOURCE CODE ERROR FLAGS 


Columns 1 through 4 of the Assembler listing can contain up to four alphabetic characters 
(flags) which indicate possible errors in the source language statement. Columns 5-10 contain a 
six-digit decimal number corresponding to a sequential count of the source statements read. The 
error flags that can be produced by the Assembler are as follows: 


NexXCHMADRHVOSOAZAZMSCTERAaBOCAOWP 2 
Q 
0> 


Meaning 
Operand field format error 


Byte allocation error 

Numeric conversion error 

Out of range short displacement 

Illegal address expression 

Illegal forward reference 

Improper header 

Function Error 

Label field format error 

Multiply-defined symbol 

No matching left parenthesis 

Illegal operation code 

Assembler control statement operand error 
Address <0 or 232K 

Illegal register reference 

Improper statement format 

Truncation warning constant/string constant 
Undefined symbol 

Expression too complex 

Conditional assembly error 


STATEMENT REFERENCE FLAGS 


Flag 
K 


Pp 
T 
X 


Meaning 


Statement contains a reference to a common location 

Statement contains a P-relative reference to an external symbol 
Statement contains a reference to a temporary label 

Statement contains a reference (other than P-relative) to an external 
symbol 


SOURCE CODE ERROR 
NOTIFICATION BY ASSEMBLER E-1 CBO7 | 


Appendix F 


Source Code Error Notification 
By Macro Preprocessor 


The Macro Preprocessor issues error flags for nonfatal errors in the source code. Each 
statement that contains a nonfatal error appears in the expanded source module as a comment 
statement with the appropriate error flag(s). 


An error flag is an alphabetic character that denotes the cause of an error. There can be up to 
four error flags per statement; subsequent errors are not designated. In a listing, column 1 
contains an asterisk, columns 2 through 5 contain the error flag(s), column 6 is blank, and 
subsequent columns contain the source statement and other pertinent information. Error flags 
that can be produced by the Macro Preprocessor are listed below. 


Error Flag Meaning 

Operand field format error 

Numeric conversion error 

Illegal expression 

Invalid macro routine, MAC statement, or ENDM statement 
Macro function error 

Label field format error 

Multiple inline macro routines were assigned the same name 
No matching left parenthesis | 
Illegal operation code 

Improper statement format 

Truncation warning 

Variable/parameter error in macro call or MAC statement 
Expression too complex 

Directory or file specified cannot be found 

Conditional processing error 


NK KX<FnNOAEBroU wap 
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Appendix G 
( Reserved Symbolic Names 


The following is an alphabetic list of all symbolic names (labels and identifiers) that have been 
defined within the Assembler and may not be redefined. | 


Reserved 

Symbolic 

Name Definition 

$ Current location 

$A...$Z Temporary labels 

$AF Address format 

$B1,$B2,...3B7 Base registers 1 through 7 
$COMM! Name of unlabelled common 

$IV Interrupt vector for current priority 


level 
$M1,$M2,...8M7Mode control registers 1 through 7 
$R1,$R2,..6R7 General registers 1 through 7; index 
registers 1 through 3 


$RZERO Relocatable address zero 
$S1,$S82,$S3 Scientific registers 1 through 3 
$SW External switch status 
( All reserved symbols added to future versions of Level 6 Assemblers will begin with a dollar sign 


($). It is therefore recommended that user-defined labels not begin with §. 


1This symbol is only reserved if the program contains an unlabelled COMM statement. 
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Appendix H 


Programmer’s Reference Information for 
Commercial Processor Operation 


INTERNAL FORMATS OF COMMERCIAL PROCESSOR INSTRUCTIONS 


The operation code field shown in the Commercial Processor instruction formats, Figure H-1, 
must specify one of the commercial instructions in Table H-1. The data descriptor (DD) specifies 
the type, size, and location of the operand. Not all instructions require three data descriptors. 
The number and type of data descriptor for each instruction is given in Table H-1. In a 
Commercial Processor instruction, a label may occupy the 12 high order bits of a word and is 
capable of addressing any of up to 4K remote data descriptors. The label designates an offset 
from the remote descriptor base address contained in the CPU remote descriptor base register 
(RDBR). This register can be accessed by use of the CPU instructions LRDB and SRDB. Figure 
H-2 shows how the remote descriptor address is generated. 


Format of Alphanumeric, Numeric, and Edit Instructions 


0 10 11 15 
000 00 8-00 0 Oi % Kk eX -X One Word 
INSTRUCTION op code 
See DATA DESCRIPTOR - DD] | Two words 
TORS (ID) ~ [ LDATA DESCRIPTOR - e200 _ 
| DATA DESCRIPTOR - DD3 
One Word 
INSTRUCTION op code 
USING REMOTE 
DATA DESCRIP- } One word 
TORS (RD) 
INSTRUCTION 0 0.0. 0 0-0 0°00 One Word 
USING A COM- op code 
BINATION OF DATA DESCRIPTOR - ODI } Two words 
IN-LINE AND ene 
REMOTE DATA ne wor 
J 
DESCRIPTORS | 
0 12 15 
Format of Branch Instructions 
0 1 3 4 7 8 9 15 
jo joP cove} 0 0 1 1 |t/F| DISPLACEMENT? 


a 


41 the displacement value specified is 0, the location to be 
branched to is specified in the next sequential word; if it 
is 1, the next sequential word specifies the displacement 
(in words) from the address of this displacement word to 
the destination; otherwise,the displacement value specified 
is the displacement, in two’s complement form, from the 
current instruction to the destination. 


L_True/False 
Specifies which commercial indicator is to be tested 


Figure H-1. Internal Formats of Commercial Processor Instructions 
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TABLE H-1. COMMERCIAL INSTRUCTION SUMMARY 


NO. OF 
OPE~ 
RANDS TYP 


INSTRUCTION 


MNEM- 
ONIC NAME 


ies] 
1) 
ig 
hf: 
| 
WN 
| 


OPERATION 


Decimal Multiply 0029 2 
(NN) 


[DD1]:: [DD2]+ 


pare IND 


DD2(L) then ex- 
tended shorter 
operand as speci- 
fied by DD2 


Fill character 
defined by DD2 
is used directly 


0022 2 
(AA) 

0023 3 
(AAA) 


0028 
(AAA) 


0020 
0026 3 
(NAA) 


0024 
(AAA) 


NOTE: In this table, A means alphanumeric operand, 
B means binary operand, and 
N means numeric operand. 


Alphanumeric Move 
and Translate 


[DD1] Trans- 
late>[DD2] 

DD3 specifies 
256 byte Trans 
late Table 
{DD3] is 
searched using 
[DD1] as SL. 

Result »G, L 

indicators and 
displacement,SA 
number +[DD2] 


= [BE [ts | Ic | 
DAD Decimal Add 002c 2 N x xX] xX] xX > ale > a a> 4 
(NN) @ 
DSB Decimal Subtract 002D 2 N x xX} Xj] xX x x Xx x X [DD2]-{DD1] > 
(NN) [DD2] 
DDV Decimal Divide 002B 3 N x xX} xX] xX x 
(NNN) 
DCM Decimal Compare 002F 2 N X| X xX x x x [DD1]::[DD2]> Is DD1 G or L 
(NN) IND than DD2? Zero 
fill to the left 
supplied for 
smaller operand. 
DMC Decimal Move and 0025 z. N X Xx] X |X X X Xx X X [DD1] conver- Combinations are 
Convert (NN) [DD2] Sy “one, 
P>S, P>P 
CBD Convert Binary 0027 2 N x Xx X x Xx X [DD1] conver- Binary operand 
to Decimal (BN) [DD2] is in 2's com- 
| plement form. 
CDB Convert Decimal 002A 2 N Xx xX xX x X xX [DD1] conver- Binary result is 
to Binary (NB) (DD2] a 2's complement 
number 
DSH Decimal Shift 002E 1 N X Ki x | xX | xX x Shift [DD1]} "q"= shift dis- 
(N) Left "d" tance,OV indica- 
' tor and Trap, 
= leo x x x avs a valid only for 
g shift left. Opt- 
ional Rounding 
during a shift 
right. . 
ALR Alphanumeric Move 0021 2 A xX X xX [DD1]+[DD2] Fill or do not 
(AA) fill to the right 
defined by DD2. 
ACM Alphanumeric Com- a j a If DD1(L) #4 
ii i | 
A 


SRH Alphanumeric 


Search 


1% 
Ree 
~ < 
a a 
Hes ~ 
a a 


VRE 


Alphanumeric 
Verify 


[DD3] is veri- 
fied using [DDl 
as VL. Result 
>G, L indica- 
tors and dis- 
placement~+[DD2] 


Decimal Move 
and Edit 


[DD1] Edited+ 
[DD2] DD3 speci 


DD1=Decimal Des- 


cription 
fies Micro-ops | pp2=Alphanumeric 
._Descriptor 


DD3=Alphanumeric 
Descriptor. 


DD1=DD2=DD3= 
Alphanumeric 
Descriptors 


* 
ax, 
al 
cl 
a 
Leesa 
a 


\ ° 
Alphanumeric Move 


R A [DDl] Edited+ 
and Edit 


[DD2] DD3 speci- 
fies Micro-ops 


7. 

* 
io 
i 
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TABLE H-1 (CONT). COMMERICAL INSTRUCTION SUMMARY 


2 INDICATORS TRAP 
MNEM- a OPE- 2 INSTRUCTION 


CBOV Branch on Overflow |[130+xx 

CBNOV Branch If No 138+xx 
Overflow 

CBTR Branch on Trunca- 230+xx 
tion 

CBNTR Branch if No 238+xx 
Truncation 

CBSF Branch on Sign 330+xx 
Fault 


CBNSF Branch If No Sign 333+xx 
Fault 


- 


CSNCB Syne and Branch 


COMMENT 


Branch to EA if 
CI(0) is set 
Branch to EA if 
CI(0) is not set 
Branch to EA if 
CI(1) is set 
Branch to EA if 
CI(1) is set 
Branch to EA if 
CrI(2) is set 


Wait for comple- 
tion of previous 
instruction (if 
necessary) before 
going to the next 
instruction. No 
Operation is per- 
formed. 


Branch to EA if 
CI(2) is not set 


438+xx 


Wait for comple- 
tion of previous 
instruction (if 
necessary)then un- 
conditionally 
branch to EA. 


CBE Branch If Equal 5 Branch to EA if 
CI(5) = CI(6) = 0 

CBNE Branch If Not 5 
Equal 

CBG Branch if Greater O+xx a 

CBLE Branch if Less 
Than or Equal 

CBL Branch If Less 730+xx 
Than 

CBGE Branch If Greater 7384+xx 
Than or Equal 


Branch to EA if 
either CI(5) or 
CI(6) = 1 


Branch to EA if 
cI(5) = 1 


ron eA U Ss 
Ww w Ww 
S| oo 3 
+ + + 
*~ x bl 
x * a 


Branch to EA if 
CI(5) = 0 


Branch to EA 1 
c1(6) = 1 


Oo 
WwW 


otXxX 


CI(6) = 0 
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0 | 10 11 15 
ae : 0000000000 i711X X X X X 
efines the 
location of RD LABEL 0 0 0 0 


CPU Remote) Q 
Descriptor 


Base 
Register a 


[RDBR] + ([Label] x 2) 
eed 


REMOTE DESCRIPTOR ARRAY 


two words 
each 
Maximum 
Number of 
Entries 
is 4k 
RDs 


Figure H-2. Remote Descriptor Address Generation 


INTERNAL FORMAT OF DATA DESCRIPTORS 
DECIMAL DATA DESCRIPTORS 


Decimal data descriptors can specify either unpacked decimal or packed decimal data. An 
unpacked decimal digit occupies one byte (8 bits); a packed decimal digit occupies 4 bits. A 
decimal data descriptor consists of two words as shown by Figure H-3. The contents of Word 2 is - 


either a displacement or an immediate memory operand (IMO) and is specified by the address 
syllable (AS) or Word 1. 


0 1] 2 3 7 8 9 15 
DISPLACEMENT OR IMO WORD 2 


Figure H-3. Decimal Data Descriptor Format 


For unpacked decimals, the meaning of the Word 1 fields is as follows. 

C1 specifies the byte offset | 

e When no indexing is specified, C1 specifies the offset within the addressed word. 
— If C1 is zero, the operand starts in the leftmost byte of the addressed word. 
— If C1 is one, the operand starts in the rightmost byte of the addressed word. 


e When indexing is specified, the contents of C1 are added to the index value and the sum is 
used in calculating the effective address. 
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yt 
aP 


C2 and C3 specify the sign convention as shown below. 


Unsigned (assumed to be positive) 


Trailing Overpunch 


Leading Separate Sign 


Trailing Separate Sign 


L specifies the length of the operand in bytes. For unsigned or sign overpunched operands, all 
bytes contain digits. For separate signed operands, one byte contains the sign designation; the 
remaining bytes contain digits. If the contents of the L field is zero, the length is specified by bits 
11 through 15 of an R register. The R register used depends on the data descriptor as follows: 


R4 for DD1 
R5 for DD2 
R6 for DD3 


When the length is specified by an R register, bits 8 through 10 of the register must be zero; 
otherwise; the results are unspecified. The length in bytes can be from 1 taroug) 31. An illegal 
specification (IS) trap is generated: 


e If an operand has a length of zero, or 

e Ifaseparate signed operand has a length of one byte (i.e., if the operand consists of only a 
sign). 

T specifies the type of decimal. The T bit must be zero for unpacked decimals. 


AS specifies the address syllable prescribed by the instruction. See Figure H-6 for the address 
syllable format. 


PACKED DECIMALS | 
For packed decimals, the meaning of Word 1 fields is as follows. 
C1 and C2 specify the digit (4-bit) offset to the first digit. 


e When no indexing is specified, C1 and C2 specify the offset within the addressed word as 
shown below. 


C1 C2 _ No. of digits offset Bit position within addressed word 
0 0 0 0:3 

0 1 1 4:7 

1 0 2 8:11 

1 1 3 12:15 


e When indexing is specified, the offset value contained in C1 and C2 is added to the index 
value and the sum is used in calculating the effective address. 


C3 specifies the sign convention. 
e If C8 is zero, the operand is unsigned. (It is assumed to be positive.) 
e If C8 is one, the operand has a trailing sign. 


L specifies the length of the operand in 4-bit digits. The length is specified directly in the field, 
or indirectly in an R register in the same way as for string decimals. 


T specifies the type of decimal. The T-bit must be one for packed decimals. 


AS specifies the address syllable prescribed by the instruction. See Figure H-6 for the address 
syllable format. 
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ALPHANUMERIC DATA DESCRIPTOR 


The format of an alphanumeric data descriptor is given in Figure H-4. The contents of Word 2 
is either a displacement or an immediate memory operand (IMO) and is specified by the address 
iia of Word 1. 


DISPLACEMENT OR IMO 


Figure H-4. Alphanumeric Data Descriptor Format 


The meaning of the Word 1 fields is as follows. 

C1 specifies the byte offset. 

e When no indexing is specified, C1 specifies the offset within the addressed word. 
— If C1 is zero, the operand starts in the leftmost byte of the addressed word. 
— If Cl is one, the operand starts in the rightmost byte of the addressed word. 


e When indexing is specified, the contents of C1 are added to the index value and the sum is 
used in calculating the effective address. 


C2 is used for controlling fill operations. C2 is meaningful only when specified by DD2 of two 
instructions: alphanumeric move (ALR) and alphanumeric move and translate (MAT). See 
detailed descriptions of these instructions. 


Bit 2 must be zero. 


L specifies the length of the operand in bytes and the fill character when one is required. If the 
L field is not zero, its contents specify the length and the fill character is an ASCII blank 
(hexadecimal 20). If the L field is zero, the length is specified by bits 11 through 15 of an R 
register. The R register used depends on the data descriptor as follows: 


R4 for DD1 
R5 for DD2 
R6 for DD3 


When specified directly the maximum length is 31 bytes. When specified by an R register, the 
maximum length is 255 bytes. When the L field of a DD2 is zero, the fill character, if required, is 
specified by bits 0 through 7 of register R5. 


Bit 8 must be zero; otherwise an illegal specification (IS) trap occurs. 


AS specifies the address syllable prescribed by the instruction. See Figure H-6 for the address 
syllable format. 


BINARY DATA DESCRIPTOR 


The format ofa binary data descriptor is gien in Figure H-5. The contents of Word 2 is either a 


displacement or an immediate memory operand (IMO) and is specified by the address syllable of 


Wo wl 1 
Ora 1. 


DISPLACEMENT 


Figure H-5. Binary Data Descriptor Format 
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The meaning of the Word 1 fields is as follows. 

C1 specifies the byte offset. 

e When no indexing is specified, C1 specifies the offset within the addressed word. 
— If C1 is zero, the operand starts in the leftmost byte of the addressed word. 
— If C1 is one, the operand starts in the rightmost byte of the addressed word. 


e When indexing is specified, the contents of Cl are added to the index value and the sum is 
used in calculating the effective address. 


Bits 1 and 2 must be zero. 
L specifies the binary precision which must be 16 or 32 bits. 
e IfLis not zero, it must be two (for a precision of 16 bits) or four (for a precision of 32) bits. 


e If Lis zero, the precision is specified by bits 11 through 15 of register R4 for DD1 and Rd for 
DD2. When these registers are used, bits 11 through 15 must contain two or four. 


Bit 8 must be zero; otherwise, an illegal specification (IS) trap occurs. 


AS specifies the address syllable prescribed by the instruction. See¥ igure H-6 for the address 
syllable format. 


Note that a binary data descriptor is actually an alphanumeric data descriptor specifying no 
fill with a length, after possible escape to Rn, of either 2 bytes or 4 bytes. 


ADDRESS SYLLABLE 


The Commercial Processor address syllable occupies bits 9 through 15 of a datu descriptor as 
shown by Figure H-6. 


Figure H-6. Commercial Processor Address Syllable Format 


Table H-2 lists the address expressions that can be specified by the Commercial Processor 
address syllable. In this table, n can be any; number from 1 through 7 and is equal to rrr, except 
when rrr = 000. The last four bits of an address syllable cannot be zeros. Ifthe last four bits of the 
word are zeros, the word is a label that designates a remote descriptor. 


Table H-2. COMMERCIAL PROCESSOR ADDRESS SYLLABLES 


m rrr = 000 rrr = 001 through 111 


mm 
Pp i=o | igri i=1 
000 | Remote *$Bn.value 
001  |description $Bn.value.$R1 *§Bn.value.$R1 
010 usage location.$R2 $Bn.value.$R2 *$Bn.value.$R2 


O11 *$Bn.value.$R3 
100 *$Bn.value.$R4 
101 *$Bn.value.$R5 
110 *$Bn.value.$R6 
| = string constant | | snvaues 
111 $Bn.value.$R7 *$Bn.value.$R7 
= decimal_constant 


‘Not valid for use in second or third data descriptors 
The Commercial Processor program (Figure H-7) provides a comprehensive example of the 


Commercial Processor instructions. 
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NOLLVadddO MOSSHOOUd TVIOUAINWOOD YOU 
NOILVNYOANT AONAYAAAY SMAHNINVEDOUd 


8-H 


LOdO 


000001 
00002 
000003 


n0n0004 


000005 
000006 
000007 
000098 
000009 
000010 
000011 
100012 
900013 
N00014 


900015 
000016 


000017 
000018 
000019 
900020 
900021 
900022 
000023 


000024 


900025 


CIPPER 770610 


0000 


NO0E 
QOOF 


0011 


0013 


9016 


0017— 


0018 
N019 
OO1A 
0018 
901C 
001D 
NO1E 
NO1F 
003F 
9040 
0041 
0042 
9045 
0046 
A047 
0048 
0049 
OO4A 
0046 
N04C 
N04D 
OO04E 
004F 
0050 
0051 
9052 


n053° 


0054 
0055 
0056 
0057 
0058 
0059 


CIP HARDWARE TEST 


2nen 


2020 


“SAF 


* 
CIPMSG 


PASMSG 


PASNO 


PASSWD 


* 
FALMSG 


FALNN 


FATILWD 


FALPTR 
MATTBL 


AB 
MATEND 
AK 


PP1K 


Rik 


P1K 


P2k 


P3K 


P6K 


N4K 


A& 


N&K 


TITLE 


TEXT 


TEXT 


DC 


DC 


TEXT 


DC 
DC 
DC 
RESV 
OC 
DC 


RESV 
DC 


De 
DC 
DC 
DC 
DC 
DC 
DC 
DC 


DC 
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CIPPER,'770610' CIP HARDWARE TEST 


Z'00','CIP HARDWARE TEST STARTING’ 


Z'00', ‘TEST ! 


POL; § 


'FASSED' 


Z‘00', ‘TEST 


Ot, 9 


*FATLED' 


<FAILWD+2 


32,' t 
4 ED ' 


‘AB? 


3,! ’ 
0,070 


0,0,0 
1024 
P'1924! 
P'2nga! 
P'3072' 
P'o1aa' 
N'4N9S! 


*"g19;4! 


N'00008191' 
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Figure H-7. Commercial Processor Hardware Test Program 
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000027 


9000278 


100079 


000030 
900031 
009032 
000033 


000034 
900035 
1000%46 
100037 
n00038 
100039 
009040 
000041 
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005R 


005C. 
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NOSE 
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0069 
06D 


N06E 
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0079 


CIP HARDWARE TEST 


3831 
3931 
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3831 
3931 
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PAPA 
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3931 
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3931 
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3930 
4808 
4808 
4208 
4808 
4808 
0000 


001 


2020 


FFE7 
FFFR 


FFE 


FFF 


FFEEF 


=SAF 


MOP TEXT 
ABK DC 
ASTBK OC 
ABKO oe 
WK AK RESV 
N9 oc 
x 
DESTAB oc 
DESCACMOP?; 
0? 
2)3 
DESCACWKBK; 
03 
8)3 
DESCACARKO: 
0; 
8) 
RETURN RESV 
TSTNO pc 
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SAF, 0 


MND400=S100212/01/1413 


Figure H-7 (cont). Commercial Processor Hardware Test Program 
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000072 
000073 
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6C10 
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0803 
OFBT7 
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7C90 
6010 


0001 
0803 
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ABCO 
RACTO 
FR4O 
1C92 
8756 
F370 
6E 30 
F70B 
F792 
T9OFA 


R3A1 


FF9% 


FFOU 


FF89 
FF SF 
FFED 
FFER 


ON0A 


/ 
PASS 


FATL 


FATL3 


LAB 
LDV 
LDV 
SEFROUT 
MCL 

dC 


$B4,PASMSG 
$R7,0 
SROA1A 


Z7'0803' WRITE TO FRROR OUT FILE 
>FAILtY 


$B4,FALMSG 
$FP7,0 
$R6,16 


Z'0803! WRITE TO FRROR OUT FILE 


$R3,PASNO 
S$R2,FALNO 
TSTNO 
$P7,TSTNO 
Rive 

=$R6 
$R7,=10 
$R6-2'30' 
$R6,ER3.~-8R1 
$R6,hR2.$R1 
$R7,>FATL? 


€R 1 


Figure H-7 (cont). Commercial Processor Hardware Test Program 
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000197 
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000110 
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000112 
000113 
000114 
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00011 
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N00123 
000124 
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OORS 
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00R7 
N0R9 
NORA 


00BC 
MOORE 
00C0 
00C1 
00C3 
N0C4 
00F5S 
N0C7 
00C9 
N0CB 
NOCD 
NOCF 
0001 
NON 
n0N4 
0005 


0007 
N0N8 
0009 
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N0ND 
NONF 
OOF 1 
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FF6E5 


FFOl 
FFOA 
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FFBF 


FFBd 
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FFSN 


0n00 
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FFFF 
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4544 
FF7U 


FFA 


FFAU 
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0n00 
FFFF 
on0t 
FFSF 
4142 


5353 


“SAF 


J 


* NUTPUT STARTING 


START 


* TEST 


»* 


TEST 


TST292 


TST201 
* 


* TEST 
TST3 


TST301 


* 


* TEST 04 & 


TST4 


LOV 
SPCH 


CSYNC 
LOR 
CMR 
BE 


SRCH 
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MESSAGE 


ZFGQ 

ZFGQ 
$R3S5,RETURN 
$B4,CTPMSG 
$R7,0 
$R6-27 


Z'0803! WRITE TO ERROR NUT FILE 


DESCAC='PA',0,2,FILL)? 


DESCACPASSWN,0,2,FILL) 

$+2 DUMMY FOR WAIT 
$B1,PASS 

='PASS' 

PASSWD 


$R1,3 
DESCA( PASSWD .$R1,1,2,NO-FITLL)$ 


DESCACeFALPTR,O,2,-NO7F ILL) 
>TST202 

>TST201 

$B1,FAIL 

>TST3 

#B1,PASS 


$B5,AR 

$R6,MATENND 

$R6-1 

$B7,-MATTBL 

tR7r2 
DESCACSR5.0°0/,2,NO-F ILL); 


DESCACS$R6.1.-$R6,1-2,N0- FILL); 
DFSCACSB7.-1.8R7,0,2,FILL) 

$+e DIIMMY FOR WAIT 
BR6,='EN! 

$P6,MATEND42 

>TST3M1 

$R1,FATIL 

>TST4 

$B81,PASS 


$R6,3 
DESCACSR6.1.$R6-,1-e,NO° FILL); 


DESCA(ER5.0-0r,2,NO-F ILL) 
DESCAC$R7.=#1.8R7,0,2,FILL) 

b+e . DUMMY FOR WAIT 
SR6,AB 

$R6,='AR! 

>TST4N} 


Figure H-7 (cont). Commercial Processor Hardware Test Program 
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0107 
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0108 
010C 
O1NE 
0110 
N11 
N112 
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0115 
0117 
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0118 
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O1L1F 
0120 
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0125 
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N12A 
0126 
01°0 
O12F 
0130 
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0135 
0147 
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OF AS 
93C0 


0027 
0208 
4608 
0025 
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0608 
QO?A 
0608 
0208 
4301 
F840 
F970 
0904 
93C0 
OF 83 
93C0 


002C 
2588 
2588 
O02F 
2588 
2588 
1388 
7394 
6303 
1302 
OF BY 
9300 
0FB3 
9300 


002D 
2588 
P58 
002F 
22F8 
2588 
S384 
93C0 
OF B3 
93C0 


0029 
22ers 
2588 
NO02F 
2588 
2588 
5304 
93C0 
OF 83 


FFOA 


FF9O 


FFSF 
FFS6 


FFS53 
FFS4 


FFS1 
FFS2 
0001 
FFUE 
0400 
FF7F 


FFT7S 


FFaa 
FF4a 


FFut 
FFu4 


FFOR 


FFol 


FF32 
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0RON 
FF 2D 
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FF5S1! 


2800 
FF20 


FFID 
FFIF 
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LNJ $Ri,FAIL 
B >TSTS 
TST401 LANJ $R1,P4SS 
‘ 
* TEST 05 =CRD, DMC, CNB 
TSTS CRD DESCB(B1K,2); 
DESCUCUIK,0,-6/LEADING) 
DMC DESCUCUIK, 0,6/LEADING); 
DESCUCPP1K,90,6,UNSIGNED) 
COB DESCUCPPIK,0,6,UNSIGNED)3 
DESCB(B1K,2) 
CSYNC $+2e DUMMY FOR WAIT 
LDR $R7,B1K 
CMR $R7,=1024 
BF >TSTSO1 
LNJ $Ri1,F AIL 
8B >TST6b 
TSTSO1 LNJ $B81,PASS 
* 
* TEST 06 = DAN 
TST6 DAD DESCP(P1K,0,5-T)3 
DFEFSCP(P2K,0,5+T) 
DCM DESCPCP2K,0,5/T)3 
DESCP(P3K,0,5-T) 
CRNOV >TST601 
CRL >TST602 
CRG >TST602 
CROV >TST602 
B >TST601 
TST602 LNJ $Bi,FAIL 
B >TST7 
TST601 LNJ $B1,PASS 
* 
x TEST 07 = DSR 
TST7 DSB  PDESCPC(P2K,0,5-T)3 
| DESCP(P3K,0+5¢T) 
DCM DESCP(C=P'0',0,2,T)3 
DESCP(P3K,0,5-T) 
CBE >TST701 
LNJ $Bi,FAIL 
B >TST8 
TST7901 LNJ $B1,PASS 
* ‘ 
* TEST 08 = OML 
TST8 DML DESCP(=P'2',0,2,T)3 
DESCP(PPK,0,57T) 
DCM DESCPCP2AK,0-5-T)3 
DESCP(P6K,0-5-T) 
CRNE >TST801 
LNJ $R1,PASS 
B >TST9 


Figure H-7 (cont). Commercial Processor Hardware Test Program 
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000182 O1%8 9300 FF4BR TST801 LNG $R84,F AIL 

000183 * 

000184 * TEST 09 = PDV 

900185 413A 0028 TST9 DOV DESCP(P6K,0-5,7T)3 
N13B 258 FFI6 

109186 0130 2588 FF14 DESCPCP6K,0,5-T)? 

N001R7 O13F 2588 FFOC DESCPIP1K,0,5,T) 

000188 oO141 O002F DCM DESCPCHP'1',Oree tT)? 
0142 22F8 100 

0090189 0144 P5888 FFO? DESCP(P1K,0,/54T) 

000190 0146 13905 CROV >TST901 

000191 0147 S304 CRANE >TST9I0I 

100192 0148 93C0 FF31 LNJ $B1,PASS 

100193 914A OFS ‘a >TST1IO 

000194 N14B 9300 FFSS TST9NI LNJ $R1,FAIL 

000395 * 

009196 * TEST 19 = DSH 

N00197 A14D O02E TST10 DSH DESCUCN&K,0,4,U),1 


014E€ 0408 FFOS 
9150 178 0001 

000198 8152 O02E DLS DESCUCN4K,064,U),1 
9153 0408 FFON 
0155 0178 0109 

900199 O157 OOCE DRS DESCUCN4K,0-4,U),3,R 
9158 408 FEFR 
015A 0178 8300 


900200 O15C 02F DCM DESCUCN9,0,1,U)3 
0150 108 FFOF 

000201 O1S5F 408 FEF4 DESCUC(N4K,0-,4,U) 

000202 0161 S3AG CRE >TST101 

009203 O162 93C0 FFIE LNJ $R1,FAIL 

100204 A164 0FR3 B >TSTi! 

000205 0165 93C0 FF14 TST101 LNJ S$R1i,PASS 

000206 * 

000207 x TEST 11 =DME 

000208 O1467 1026 TST11 DME DESCUC(N8K,0,8,U)3 
0168 0808 FFEF 

100209 O16A 4808 FEFE DESCACWK8K,0,8)? 

000210 016C 4208 FEEF DESCA(MOP,0,2) 

OON2t1 O16E 022 ACM DESCACWKBK,0,8)? 
O16F 4808 FFEF9 

009212 0171 4e0e8 FEEF DESCACAST&K.0,-8) 

000213 0173 2303 CRTR >TST1i12 

000214 0174 3302 CRSF >TST112 

000215 0175 5384 CRE >TSTi11 

009216 0176 93C0 FFOA TST112 LNJ $81,F AIL 

009217 0178 OFB&3 B >TST12 

100218 0179 93C0 FFOO TST111 LNJ $B81,PASS 

N00219 * 

000220 * TEST 12 -AME 

000221 0178 024 TST12 AME ~ DESCACA8,0,8&); 
017C 4808 FED9 

N0N222 O17E 4808 FEEA . DESCACWKBK,0,8)?3 

000223 0180 4298 FEDR DESCACMOP, 0-2) 

000224 0182 0022 ACM DESCACWKBK,0,8)3 
0183 4808 FEES 

000225 0185 4808 FEDF DESCACA8K0,0,8) 

N09226 0187 5384 CRE >TST121 

000227 0188 93C0 FEFR LNJ $R1,F AIL 

100228 O18A OF R3 B >TST13 


Figure H-7 (cont). Commercial Processor Hardware Test Program 


VI-H NOILVYAdO YOSSHIOUd TVIOUMWINOD YOu 
NOILVWYOUNI SONGTHHdaa SMANIANVAOOUd 


LOdO 


CIPPER 770610 


NN0N229 
100230 
000231 
N0N232 
000233 
000234 
100235 
100236 


900237 


900238 
000239 
000240 
000241 
000242 
N0N243 
000244 
N0N24S 


9188 


018D 
O1AF 
N191 
0192 
0193 
0194 
0195 
0196 
0197 
0198 
0199 
019A 
019C 


N19E 
N1A0 


N1A2 


0001 ERR COUNT 
00368 WORD SYMBOL 


93C0 


RBCO 


CBCO FEDE 


O0NC 
0024 
0000 
9010 
0020 
N0?2 
0030 
040 
S385 
93C0 
A3C8 


93C0 
83C8 


TARLE 


CIP HARDWARE TEST 


FFEE 


FEEQ 


FFE6 
FEDR 


FEDB 
FED7 


0N9R 


“SAF 


* 


TST121 


* 


* TEST 
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TST131 
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13 = REMOTE 


LAB 
LAB 
LROB 
AME 


ACM 


CRE 
LNJ 
JMP 


LNJ 
JMP 


END 
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$B1,PASS 
DESCRIPTORS 
$83,DESTAR 
$R4,DESTAR 


Orire 


3,4 


>TST131 
$Bi,FAIL 
*RETURN 


$81,PASS 
xRE TURN 


CIPPER,START 
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Appendix J 


Programmer’s Reference 
Information For Queue Instructions 


The queue instructions! allow easy maintenance of ordered lists of “frames.” A frame contains 
a frame priority number, a next frame pointer, and an associated data structure. Each list is 
identified by a lock frame that contains a lock word and pointers to the head and tail of the list. 


See Figure J-1. 
Four generic instructions are provided to enqueue or dequeue frames from the list: 
e Queue on head (QOH) 
e Queue on tail (QOT) 
e Dequeue from head (DQH) 
e Dequeue by address (DQA) 


The lock word ensures that only one CPU accesses a particular queue at a time. Each queue 
instruction causes a fetch of the lock word with a Read-Modify-Write (RMW) cycle. If the low 
order bit of the lock word is set: 


e The RMW cycle is completed without changing the lock. 
e The carry bit of the indicator register is cleared. 
e The next instruction is fetched. 
If the low order bit of the lock word is cleared: 
e The RMW cycle is completed and ones are written into the lock word. 
e Execution of the queue or dequeue instruction is initiated. 


Each queue or dequeue instruction causes a scan of the frames from the head toward the tail. 
When the conditions specified by the instruction are met, or the last frame is reached, the CPU: 


e Links or unlinks the frame from the list 
e Leaves the G- and L-bits of the indicator register in a known state 
e Initiates another RMW cycle 
e Writes zeros into the lock word 
e Sets the carry bit of the indicator register to one 
e Fetches the next instruction 
If an interrupt occurs during a scan, the CPU: 
e Stops the scan 
e Initiates an RMW cycle 
e Writes zeros into the lock word 
e Clears the carry bit of the indicator register to zero 
e Leaves the G- and L-bits of the indicator register undefined 
e Sets the program counter to point to the queue or dequeue instruction being interrupted 


After performing these actions, the CPU services the interrupt. 


During the scan, the effective ring number is moved outward (i.e., becomes less privileged), if 
the frame being scanned is in a lower privilege ring. If the frame is in a higher privilege ring, 
standard protection procedures are carried out by the Memory Management Unit. 

Software must build the lock frame of each list to be used. A list with no entries is a lock frame 
in which the first and last frame pointers point to LOCK. (See Figure J-1) The CPU will leave 
the lock frame in this condition when a frame is unlinked from a list having a single frame. 


1These instructions are only available on the 6/40 and 6/50 models. 


PROGRAMMER’S REFERENCE , 
INFORMATION FOR QUEVE INSTRUCTIONS = J-1 CBO07 


LOW MEMORY 


LOCK S PRIORITY PRIORITY : PRIORITY ae 


FIRST | NEXT NEXT LOCK 
FRAME : FRAME FRAME POINTER 
POINTER POINTER POINTER 


LAST 
FRAME DATA DATA DATA 
POINTER 


~eee_eee” 


FIRST FRAME INTERMEDIATE LAST FRAME 
EOCICERAME (HEAD) FRAME (TAIL) 


HIGH MEMORY 
NOTES: 1. SCANNING (IF ANY) IS ALWAYS PERFORMED FROM FIRST FRAME (HEAD) 


TO LAST FRAME (TAIL). 
2. PRIORITY IS AN UNSIGNED 16 BIT INTEGER. 


3. FRAME POINTERS ARE TWO WORDS FOR LAF CONFIGURATION, 1 WORD 
FOR SAF CONFIGURATION 


LOCK FRAME FOR ZERO ENTRY LIST 


Figure J-1. Queue Management 


The following DC statement will create an empty queue. 


QUEUE DC 0; LOCK WORD 
<QUEUE; FIRST FRAME POINTER 
<QUEUE LAST FRAME POINTER 


PROGRAMMER’S REFERENCE | 
INFORMATION FOR QUEUE INSTRUCTIONS — J-2 | | CBO7 


Appendix K 


7 Programmer’s Reference 
( Information For Stack Instructions 


The Model 6/40 and 6/50 systems provide a single stack capability for each interrupt level. The 
stack address register, T, contains the address of the first word of the stack header. The stack 
header is shown in the diagram of the stack structure, Figure K-1. 

Four generic instructions are provided for managing the stacks. These instructions are 
two-word instructions each of which has the same first word. During execution of the instruc- 
tions, checks are made for stack overflow and stack underflow. 


STACK FRAME 


The stack header contains four entries, two of which must be null pointers as shown by Figure 
K-1.The number of words allocated to a stack, MW, is written by the software when the header 
is created. It is referenced, but not altered, by the hardware. The number of words currently 
consumed in a stack, CW, is written by the software when the header is created. Thereafter, the 
value of CW is maintained by the hardware. 


comedy AVAILABLE 
MEMORY, STACK 
( TOP OF STACK SPACE os 
LENGTH (b) OF FRAME B 
[BN] AFTER 
MW ACQUIRING 
FRAME B b STACK FRAME B 
LENGTH (a) OF FRAME A 


= 
a STACK FRAME A 
STACK CURRENT LENGTH IN WORDS (CW) 
ADDRESS (T) 


REGISTER 
MAXIMUM LENGTH IN WORDS (MW) STACK 
HIGHER IN ee 
MEMORY, BOTTOM MBN* 
OF STACK 
| 


*MUST BE NULL 


Figure K-1. Stack Structure 


PROGRAMMER’S REFERENCE | | 
INFORMATION FOR STACK INSTRUCTIONS ~ K-1 CBO07 


STACK INSTRUCTION FORMATS 
LOAD STACK ADDRESS REGISTER (LDT) 


WORD 1 WORD 2 


pe rn ck Rene a _ ILE LENE ALOE AT SE ESTER 
9} Oo} 1] oO} of} 2 Joxxx} 0 | 


Designates base register (1- 7) 


The LDT instruction loads the T register with the address contained in the specified base 
register. 


STORE STACK ADDRESS REGISTER (STT) 
WORD 1 WORD 2 


EEE AT TET TERT TT EE EE OT 
po} ofr joftojojoj}o 


The STT instruction loads base register 7 with the address contained in the T register. 
ACQUIRE STACK FRAME (ACQ) 


WORD 1 WORD 2 


LA, A 
ro Lo [1 [0 [0] 0 [oxox 


Designates base register 27) 
Designates general register (1-7) 
The ACQ instruction loads the leftmost address of the newly acquired frame into the 
designated base register Bn, writes the length of the new frame into the previous location, and 
updates the current stack length accordingly. The designated general register Rn contains the 


number of words of stack space to be acquired. A trap to Trap 10 (stack overflow) occurs if the 
number of words to be acquired exceeds the available stack space. 


RELINQUISH STACK FRAME (RLQ) 
WORD 1 WORD 2 


Deemer manners Se oN 
o fot 1 jo fo} of o foxx 
Snare see” 


Designates base register (1-7)— 


The RLQ instruction converts the top (most recently acquired) stack frame into available 
space by updating the current length (CW) in the stack header. A trap to Trap 9 (stack 
underflow) occurs if the stack is emptied; i.e., if CW becomes zero. If the stack is not emptied, the 
leftmost address of the new top frame is loaded into the designated base register. 
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